C++ 参考手册

位置:首页 > C++ 参考手册 >日期和时间工具 > 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)
比较两个时长
(函数模板)
转换时长到另一个拥有不同嘀嗒间隔的时长
(函数模板)
以向下取整的方式,将一个时长转换为另一个时长
(函数模板)
以向上取整的方式,将一个时长转换为另一个时长
(函数模板)
转换时长到另一个时长,就近取整,偶数优先
(函数模板)
获取时长的绝对值
(函数模板)
进行 duration 上的流输出
(函数模板)
按照提供的格式,从流分析 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 年的范围。

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

(C++20 起)

辅助类

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

字面量

定义于内联命名空间 std::literals::chrono_literals
表示小时的 std::chrono::duration 字面量
(函数)
表示分钟的 std::chrono::duration 字面量
(函数)
表示秒的 std::chrono::duration 字面量
(函数)
表示毫秒的 std::chrono::duration 字面量
(函数)
表示微秒的 std::chrono::duration 字面量
(函数)
表示纳秒的 std::chrono::duration 字面量
(函数)

注意:字面量后缀 dy 不指代 daysyears ,而是分别指代 dayyear

(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