C++ 参考手册

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

std::chrono::time_point

定义于头文件 <chrono>
template<

    class Clock,
    class Duration = typename Clock::duration

> class time_point;
 (C++11 起)

类模板 std::chrono::time_point 表示时间中的一个点。它被实现成如同存储一个 Duration 类型的自 Clock 的纪元起始开始的时间间隔的值。

Clock 必须满足时钟 (Clock) 的要求或为 std::chrono::local_t (C++20 起)。

成员类型

 
成员类型 定义
clock Clock ，此时间点在此时钟上计量
duration Duration ，用于计量从纪元起时间的 std::chrono::duration 类型
rep Rep ，表示时期的计次数的算术类型
period Period ，表示时期周期的 std::ratio 类型

成员函数

 构造新的 time_point
(公开成员函数)
返回表示为从其时钟起点开始的时间点
(公开成员函数)
以给定的 duration 修改 time_point
(公开成员函数)
(C++20)
 自增或自减 duration
(公开成员函数)
[静态]
 返回对应最小时长的时间点
(公开静态成员函数)
[静态]
 返回对应最大时长的时间点
(公开静态成员函数)

非成员函数

 实施涉及时间点的加法和减法运算
(函数模板)
(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20 中移除)(C++20)
 比较两个时间点
(函数模板)
转换时间点为同一时钟上拥有不同时长的另一时间点
(函数模板)
(C++17)
 转换 time_point 到另一个，向下取整
(函数模板)
(C++17)
 转换 time_point 到另一个，向上取整
(函数模板)
(C++17)
 转换 time_point 到另一个，就近取整，偶数优先
(函数模板)

辅助类

 特化 std::common_type 特征
(类模板特化)

示例

运行此代码
#include <iostream>
#include <iomanip>
#include <ctime>
#include <chrono>
 
int main()
{
    std::chrono::system_clock::time_point now = std::chrono::system_clock::now();
    std::time_t now_c = std::chrono::system_clock::to_time_t(now - std::chrono::hours(24));
    std::cout << "24 hours ago, the time was "
              << std::put_time(std::localtime(&now_c), "%F %T") << '\n';
 
    std::chrono::steady_clock::time_point start = std::chrono::steady_clock::now();
    std::cout << "Hello World\n";
    std::chrono::steady_clock::time_point end = std::chrono::steady_clock::now();
    std::cout << "Printing took "
              << std::chrono::duration_cast<std::chrono::microseconds>(end - start).count()
              << "us.\n";
}

可能的输出： 

24 hours ago, the time was 2011-10-25 12:00:08
Hello World
Printing took 84us.

参阅

(C++11)
 时间区间
(类模板)