std::chrono::time_point

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

日期和時間庫

時間點 time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) 時長 duration (C++11) 時鐘 system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) 日間時間 is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

日曆 day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono I/O parse (C++20)

時區 tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C風格日期和時間

 

std::chrono::time_point

成員函式

time_point::time_point

time_point::time_since_epoch

time_point::operator+=time_point::operator-=

time_point::operator++time_point::operator-- (C++20)(C++20)

time_point::min

time_point::max

非成員函式

operator+operator-

operator==operator!=operator<operator<=operator>operator>=operator<=> (直至 C++20)(C++20)

time_point_cast

floor (C++17)

ceil (C++17)

round (C++17)

輔助類

common_type

hash<std::chrono::time_point> (C++26)

 

定義於標頭檔案 <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 起)。

(直至 C++23)

成員型別

成員型別	定義
clock	Clock，此時間點所基於的時鐘
duration	Duration，一個 std::chrono::duration 型別，用於衡量自紀元以來的時間
rep	Rep，一個算術型別，表示時長的“滴答”計數
period	Period，一個 std::ratio 型別，表示時長的“滴答”週期

成員函式

(建構函式)	構造一個新的時間點 (public 成員函式)
time_since_epoch	返回自其時鐘紀元開始以來的時長作為時間點 (public 成員函式)
operator+=operator-=	按給定時長修改時間點 (public 成員函式)
operator++operator++(int)operator--operator--(int) (C++20)	增加或減少時長 (public 成員函式)
min [靜態]	返回對應於最小時長的時間點 (public static 成員函式)
max [靜態]	返回對應於最大時長的時間點 (public static 成員函式)

非成員函式

operator+operator- (C++11)	執行涉及時間點的加法和減法運算 (函式模板)
operator==operator!=operator<operator<=operator>operator>=operator<=> (C++11)(C++11)(在 C++20 中移除)(C++11)(C++11)(C++11)(C++11)(C++20)	比較兩個時間點 (函式模板)
time_point_cast (C++11)	將一個時間點轉換為同一時鐘上的另一個時間點，但具有不同的時長 (函式模板)
floor(std::chrono::time_point) (C++17)	將一個 time_point 轉換為另一個，向下取整 (函式模板)
ceil(std::chrono::time_point) (C++17)	將一個 time_point 轉換為另一個，向上取整 (函式模板)
round(std::chrono::time_point) (C++17)	將一個 time_point 轉換為另一個，四捨五入到最接近的值，平局時取偶數 (函式模板)

輔助類

std::common_type<std::chrono::time_point> (C++11)	特化 std::common_type 特性 (類模板特化)
std::hash<std::chrono::time_point> (C++26)	對 std::chrono::time_point 的雜湊支援 (類模板特化)

示例

執行此程式碼

#include <algorithm>
#include <chrono>
#include <ctime>
#include <iomanip>
#include <iostream>
 
void slow_motion()
{
    static int a[]{1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12};
    // Generate Γ(13) == 12! permutations:
    while (std::ranges::next_permutation(a).found) {}
}
 
int main()
{
    using namespace std::literals; // enables literal suffixes, e.g. 24h, 1ms, 1s.
 
    const std::chrono::time_point<std::chrono::system_clock> now =
        std::chrono::system_clock::now();
 
    const std::time_t t_c = std::chrono::system_clock::to_time_t(now - 24h);
    std::cout << "24 hours ago, the time was "
              << std::put_time(std::localtime(&t_c), "%F %T.\n") << std::flush;
 
    const std::chrono::time_point<std::chrono::steady_clock> start =
        std::chrono::steady_clock::now();
 
    std::cout << "Different clocks are not comparable: \n"
                 "  System time: " << now.time_since_epoch() << "\n"
                 "  Steady time: " << start.time_since_epoch() << '\n';
 
    slow_motion();
 
    const auto end = std::chrono::steady_clock::now();
    std::cout
        << "Slow calculations took "
        << std::chrono::duration_cast<std::chrono::microseconds>(end - start) << " ≈ "
        << (end - start) / 1ms << "ms ≈ " // almost equivalent form of the above, but
        << (end - start) / 1s << "s.\n";  // using milliseconds and seconds accordingly
}

可能的輸出

24 hours ago, the time was 2021-02-15 18:28:52.
Different clocks are not comparable:
  System time: 1666497022681282572ns
  Steady time: 413668317434475ns
Slow calculations took 2090448µs ≈ 2090ms ≈ 2s.

亦參見

duration (C++11)	時間間隔 (類模板)
year_month_day (C++20)	表示特定的 year、month 和 day (類)