std::chrono::duration

来自cppreference.com
< cpp‎ | chrono
 
 
工具库
类型支持(基本类型、 RTTI 、类型特性)
动态内存管理
错误处理
程序工具
变参数函数
日期和时间
函数对象
(C++11)
关系运算符
optionalanyvariant (C++17)
pair 与 tuple
(C++11)
(C++17)
swap 、 forward 与 move
(C++14)
(C++11)
(C++11)
初等字符串转换
(C++17)
(C++17)
类型运算
(C++11)
(C++17)
 
 
 
定义于头文件 <chrono>
template<

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

[编辑] 非成员函数

特化 std::common_type 特性
(类模板特化) [编辑]
实现以时长为参数的算术运算
(函数模板) [编辑]
比较两个时长
(函数模板) [编辑]
转换 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>>

注意:每个预定义时长类型覆盖至少 ±292 年的范围。

[编辑] 帮助类

指示时长可转换为拥有不同计次的时长
(类模板)
构造给定类型计次的零、最小及最大值
(类模板)

[编辑] 字面量

定义于内联命名空间 std::literals::chrono_literals
表示小时的 std::chrono::duration 字面量
(函数) [编辑]
表示分钟的 std::chrono::duration 字面量
(函数) [编辑]
表示秒的 std::chrono::duration 字面量
(函数) [编辑]
表示毫秒的 std::chrono::duration 字面量
(函数) [编辑]
表示微秒的 std::chrono::duration 字面量
(函数) [编辑]
表示纳秒的 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