定义于头文件
<chrono>
|
||
template<
class Rep, |
(C++11 起) | |
类模板 std::chrono::duration
表示时间间隔。
它由 Rep
类型的计次数和计次周期组成,其中计次周期是一个编译期有理数常量,表示从一个计次到下一个的秒数。
存储于 duration
的数据仅有 Rep
类型的计次数。若 Rep
是浮点数,则 duration
能表示小数的计次数。 Period
被包含为时长类型的一部分,且只在不同时长间转换时使用。
目录 |
成员类型 | 定义 |
rep
|
Rep ,表示计次数的算术类型
|
period
|
Period (C++17 前)typename Period::type (C++17 起) ,表示计次周期的 std::ratio (即每秒的次数)
|
构造新 duration (公开成员函数) |
|
赋值内容 (公开成员函数) |
|
返回计次的计数 (公开成员函数) |
|
[静态]
|
返回特殊时长值零 (公开静态成员函数) |
[静态]
|
返回特殊时长值最小值 (公开静态成员函数) |
[静态]
|
返回特殊时长值最大值 (公开静态成员函数) |
实现一元 + 和一元 - (公开成员函数) |
|
递增或递减滴答计数 (公开成员函数) |
|
实现二个时长间的复合赋值 (公开成员函数) |
特化 std::common_type 特性 (类模板特化) |
|
实现以时长为参数的算术运算 (函数模板) |
|
比较两个时长 (函数模板) |
|
转换 duration 到另一个拥有不同计次间隔者 (函数模板) |
|
(C++17)
|
以向下取整的方式,将一个时间间隔转换为另一个 (函数模板) |
(C++17)
|
以向上取整的方式,将一个时间间隔转换为另一个 (函数模板) |
(C++17)
|
转换 duration 到另一个,就近取整,倾向偶数 (函数模板) |
(C++17)
|
获取时间间隔的绝对值 (函数模板) |
类型 | 定义 |
std::chrono::nanoseconds | duration</*至少 64 位的有符号整数类型*/, std::nano> |
std::chrono::microseconds | duration</*至少 55 位的有符号整数类型*/, std::micro> |
std::chrono::milliseconds | duration</*至少 45 位的有符号整数类型*/, std::milli> |
std::chrono::seconds | duration</*至少 35 位的有符号整数类型*/> |
std::chrono::minutes | duration</*至少 29 位的有符号整数类型*/, std::ratio<60>> |
std::chrono::hours | duration</*至少 23 位的有符号整数类型*/, std::ratio<3600>> |
注意:每个预定义时长类型覆盖至少 ±292 年的范围。
指示时长可转换为拥有不同计次的时长 (类模板) |
|
构造给定类型计次的零、最小及最大值 (类模板) |
定义于内联命名空间
std::literals::chrono_literals |
|
(C++14)
|
表示小时的 std::chrono::duration 字面量 (函数) |
(C++14)
|
表示分钟的 std::chrono::duration 字面量 (函数) |
(C++14)
|
表示秒的 std::chrono::duration 字面量 (函数) |
(C++14)
|
表示毫秒的 std::chrono::duration 字面量 (函数) |
(C++14)
|
表示微秒的 std::chrono::duration 字面量 (函数) |
(C++14)
|
表示纳秒的 std::chrono::duration 字面量 (函数) |
此示例演示如何定义几种自定义时长类型及在类型间转换:
#include <iostream> #include <chrono> int main() { using shakes = std::chrono::duration<int, std::ratio<1, 100000000>>; using jiffies = std::chrono::duration<int, std::centi>; using microfortnights = std::chrono::duration<float, std::ratio<12096,10000>>; using nanocenturies = std::chrono::duration<float, std::ratio<3155,1000>>; std::chrono::seconds sec(1); std::cout << "1 second is:\n"; // 无精度损失的整数尺度转换:无转型 std::cout << std::chrono::microseconds(sec).count() << " microseconds\n" << shakes(sec).count() << " shakes\n" << jiffies(sec).count() << " jiffies\n"; // 有精度损失的整数尺度转换:需要转型 std::cout << std::chrono::duration_cast<std::chrono::minutes>(sec).count() << " minutes\n"; // 浮点尺度转换:无转型 std::cout << microfortnights(sec).count() << " microfortnights\n" << nanocenturies(sec).count() << " nanocenturies\n"; }
输出:
1 second is: 1000000 microseconds 100000000 shakes 100 jiffies 0 minutes 0.82672 microfortnights 0.316957 nanocenturies