C++ 参考手册

位置：首页 > C++ 参考手册 >日期和时间工具 > std::chrono::duration

std::chrono::duration

    class Rep,
    class Period = std::ratio<1>

> class duration;
(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
(公开成员函数)
赋值内容
(公开成员函数)
返回计次的计数
(公开成员函数)
[静态]
 返回特殊时长值零
(公开静态成员函数)
[静态]
 返回特殊时长值最小值
(公开静态成员函数)
[静态]
 返回特殊时长值最大值
(公开静态成员函数)
实现一元 + 和一元 -
(公开成员函数)
递增或递减滴答计数
(公开成员函数)
实现二个时长间的复合赋值
(公开成员函数)

非成员函数

 实现以时长为实参的算术运算
(函数模板)
(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20)
 比较两个时长
(函数模板)
转换时长到另一个拥有不同嘀嗒间隔的时长
(函数模板)
(C++17)
 以向下取整的方式，将一个时长转换为另一个时长
(函数模板)
(C++17)
 以向上取整的方式，将一个时长转换为另一个时长
(函数模板)
(C++17)
 转换时长到另一个时长，就近取整，偶数优先
(函数模板)
(C++17)
 获取时长的绝对值
(函数模板)
(C++20)
 进行 duration 上的流输出
(函数模板)
(C++20)
 按照提供的格式，从流分析 duration
(函数模板)

辅助类型

 
类型 定义
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>>
std::chrono::days (C++20 起) duration</*至少 25 位的有符号整数类型*/, std::ratio<86400>>
std::chrono::weeks (C++20 起) duration</*至少 22 位的有符号整数类型*/, std::ratio<604800>>
std::chrono::months (C++20 起) duration</*至少 20 位的有符号整数类型*/, std::ratio<2629746>>
std::chrono::years (C++20 起) duration</*至少 17 位的有符号整数类型*/, std::ratio<31556952>>

注意：到 hours 为止的每个预定义时长类型至少涵盖 ±292 年的范围。

每个预定义时长类型 days 、 weeks 、 months 和 years 至少涵盖 ±40000 年范围。 years 等于 365.2425 days （格里高利年的平均长度）。 months 等于 30.436875 days （ years 的准确的 1/12 ）。

(C++20 起)

辅助类

 特化 std::common_type 特征
(类模板特化)
指示时长可转换为拥有不同计次的时长
(类模板)
构造给定类型计次的零、最小及最大值
(类模板)
(C++20)
 std::formatter 的特化，按提供的格式格式化 duration
(类模板特化)

字面量

定义于内联命名空间 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 字面量
(函数)

注意：字面量后缀 d 和 y 不指代 days 和 years ，而是分别指代 day 和 year 。

(C++20 起)

示例

此示例演示如何定义几种自定义时长类型及在类型间转换：

运行此代码
#include <iostream>
#include <chrono>
 
constexpr auto year = 31556952ll; // 格里高利历年的平均秒数
 
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<14*24*60*60, 1000000>>;
    using nanocenturies = std::chrono::duration<float, std::ratio<100*year, 1000000000>>;
 
    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.316887 nanocenturies