std::chrono:: duration

类模板 std::chrono::duration 表示一个时间间隔。

它由类型为 Rep 的滴答计数和一个滴答周期组成，其中滴答周期是一个编译期有理数 fraction ，表示相邻两次滴答之间的时间（以秒为单位）。

存储在 duration 中的唯一数据是类型为 Rep 的滴答计数。如果 Rep 是浮点数类型，则该 duration 可以表示滴答的小数部分。 Period 作为时长类型的一部分被包含，仅在不同时长类型间转换时使用。

成员类型

成员函数

非成员函数

辅助类型

下表使用的类型 /* intXX */ 表示至少具有 XX 位的有符号整数类型。

注意：每个预定义的时长类型（直至 hours ）至少覆盖±292年的时间范围。

辅助类

辅助特化

此 std::enable_nonlocking_formatter_optimization 的特化能够在模板参数 Rep 支持时，为输出 chrono::duration 对象实现高效的 std::print 与 std::println 实现。

字面量

注释

持续时间对象 d 所持有的实际时间间隔（以秒为单位）约等于 d. count ( ) * D :: period :: num / D :: period :: den ，其中 D 是 chrono::duration<> 类型，而 d 是该类型的对象。

示例

#include <chrono>
#include <iostream>
using namespace std::chrono_literals;
template<typename T1, typename T2>
using mul = std::ratio_multiply<T1, T2>;
int main()
{
    using microfortnights = std::chrono::duration<float,
        mul<mul<std::ratio<2>, std::chrono::weeks::period>, std::micro>>;
    using nanocenturies = std::chrono::duration<float,
        mul<mul<std::hecto, std::chrono::years::period>, std::nano>>;
    using fps_24 = std::chrono::duration<double, std::ratio<1, 24>>;
    std::cout << "1 second is:\n";
    // 整数比例转换且无精度损失：无需类型转换
    std::cout << std::chrono::milliseconds(1s).count() << " milliseconds\n"
              << std::chrono::microseconds(1s).count() << " microseconds\n"
              << std::chrono::nanoseconds(1s).count() << " nanoseconds\n";
    // 整数比例转换且有精度损失：需要显式转换
    std::cout << std::chrono::duration_cast<std::chrono::minutes>(1s).count()
              << " minutes\n";
    // duration_cast的替代方案：
    std::cout << 1s / 1min << " minutes\n";
    // 浮点数比例转换：无需类型转换
    std::cout << microfortnights(1s).count() << " microfortnights\n"
              << nanocenturies(1s).count() << " nanocenturies\n"
              << fps_24(1s).count() << " frames at 24fps\n";
}

1 second is:
1000 milliseconds
1000000 microseconds
1000000000 nanoseconds
0 minutes
0 minutes
0.82672 microfortnights
0.316887 nanocenturies
24 frames at 24fps