std::chrono::duration

来自cppreference.com
< cpp‎ | chrono
 
 
 
 
 
定义于头文件 <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
(公开成员函数) [编辑]
赋值内容
(公开成员函数) [编辑]
返回时间计数值
原文:
returns the count of ticks
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]
[静态]
返回值为零的特殊时间间隔
(公开静态成员函数) [编辑]
[静态]
返回时间间隔的最小值
原文:
returns the special duration value min
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开静态成员函数) [编辑]
[静态]
返回时间间隔的最大值
原文:
returns the special duration value max
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开静态成员函数) [编辑]
实现一元 + 和一元 -
(公开成员函数) [编辑]
递增或递减滴答计数
(公开成员函数) [编辑]
实现时间间隔之间的复合赋值
原文:
implements compound assignment between two durations
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(公开成员函数) [编辑]

[编辑] 非成员函数

特化 std::common_type 特性
(类模板特化) [编辑]
以时间间隔为参数进行算术运算
原文:
implements arithmetic operations with durations as arguments
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

(函数模板) [编辑]
比较两个时间间隔
(函数模板) [编辑]
转换 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