std::chrono::duration

定义于头文件 <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
(C++14)
表示小时的 std::chrono::duration 字面量
(函数)
表示分钟的 std::chrono::duration 字面量
(函数)
(C++14)
表示秒的 std::chrono::duration 字面量
(函数)
(C++14)
表示毫秒的 std::chrono::duration 字面量
(函数)
(C++14)
表示微秒的 std::chrono::duration 字面量
(函数)
(C++14)
表示纳秒的 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

版本历史

  • (当前 | 先前 2017年9月22日 (五) 05:42Fruderica讨论 | 贡献 . . (4,731字节) (-1). . (撤销)
  • 当前 | 先前 2017年5月7日 (日) 20:48Fruderica讨论 | 贡献. . (4,732字节) (-407). . (撤销)
  • 当前 | 先前 2016年2月7日 (日) 22:11Wizardforcel讨论 | 贡献. . (5,139字节) (+530). . (撤销)
  • 当前 | 先前 2016年2月3日 (三) 07:36Wizardforcel讨论 | 贡献. . (4,609字节) (+13). . (撤销)
  • 当前 | 先前 2016年2月3日 (三) 07:36Wizardforcel讨论 | 贡献. . (4,596字节) (+522). . (撤销)
  • 当前 | 先前 2016年2月3日 (三) 07:29Wizardforcel讨论 | 贡献. . (4,074字节) (+27). . (撤销)
  • 当前 | 先前 2016年2月3日 (三) 07:26Wizardforcel讨论 | 贡献. . (4,047字节) (-16). . (撤销)
  • 当前 | 先前 2014年10月26日 (日) 17:41P12bot讨论 | 贡献 . . (4,063字节) (0). . (Fix some translations) (撤销)
  • 当前 | 先前 2013年7月9日 (二) 03:07P12bot讨论 | 贡献 . . (4,063字节) (+6). . (Allow search engines to index popular pages.) (撤销)
  • 当前 | 先前 2013年7月2日 (二) 08:20P12bot讨论 | 贡献 . . (4,057字节) (-379). . (Use {{lc}}. Update links. Various fixes.) (撤销)
  • 当前 | 先前 2012年11月2日 (五) 16:40P12bot讨论 | 贡献 . . (4,436字节) (+217). . (r2.7.3) (机器人添加:de, en, es, fr, it, ja, pt, ru) (撤销)
  • 当前 | 先前 2012年10月26日 (五) 10:50P12讨论 | 贡献 . . (4,219字节) (0). . (1个修订: Translate from the English version) (撤销)
  • 当前 | 先前 2012年10月26日 (五) 07:00TranslationBot讨论 | 贡献. . (4,219字节) (-43). . (Translated from the English version using Google Translate) (撤销)
  • 当前 | 先前 2012年10月25日 (四) 14:14P12讨论 | 贡献 . . (4,262字节) (0). . (1个修订: Translate from the English version) (撤销)
  • 当前 | 先前) 2012年10月25日 (四) 13:00TranslationBot讨论 | 贡献. . (4,262字节) (+4,262). . (Translated from the English version using Google Translate)