std::chrono::utc_clock

 

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::utc_clock

成員函式

utc_clock::now

utc_clock::to_sys

utc_clock::from_sys

時間點 I/O

operator<<

formatter<std::chrono::utc_time>

from_stream

閏秒插入資訊

leap_second_info

get_leap_second_info

 

定義於標頭檔案 <chrono>
class utc_clock;		(C++20 起)

std::chrono::utc_clock 時鐘是一個 Clock，代表 協調世界時 (UTC)。它衡量自 1970 年 1 月 1 日星期四 00:00:00 UTC 以來的時間，包括閏秒。

utc_clock 滿足 Clock 要求。除非實現能保證 now() 不會丟擲異常，否則它不滿足 TrivialClock 要求。

時間點家族

定義在名稱空間 std::chrono 中
template<class Duration> using utc_time = std::chrono::time_point<std::chrono::utc_clock, Duration>;		(C++20 起)
using utc_seconds = utc_time<std::chrono::seconds>;		(C++20 起)

operator<<(std::chrono::utc_time) (C++20)	對 utc_time 執行流輸出 (函式模板)
from_stream(std::chrono::utc_time) (C++20)	根據提供的格式從流中解析 utc_time (函式模板)
std::formatter<std::chrono::utc_time> (C++20)	utc_time 的格式化支援 (類模板特化)

成員型別

成員型別	定義
rep	帶符號算術型別，表示時鐘持續時間內的“滴答”數
period	一個 std::ratio 型別，表示時鐘的“滴答”週期，以秒為單位
duration	std::chrono::duration<rep, period>，能夠表示負持續時間
time_point	std::chrono::time_point<std::chrono::utc_clock>

成員常量

constexpr bool is_steady [靜態]

如果刻度之間的時間總是恆定的，即對 now() 的呼叫返回即使在某些外部時鐘調整的情況下也單調增加的值，則為 true，否則為 false (public static 成員常量)

成員函式

now [靜態]	返回表示當前時間點的 std::chrono::time_point (公共靜態成員函式)
to_sys [靜態]	將 utc_time 轉換為 sys_time (公共靜態成員函式)
from_sys [靜態]	將 sys_time 轉換為 utc_time (公共靜態成員函式)

非成員函式

get_leap_second_info (C++20)

從 utc_time 物件獲取閏秒插入資訊 (函式模板)

輔助類

leap_second_info (C++20)

閏秒插入資訊 (類)

注意

官方 UTC 紀元是 1972 年 1 月 1 日。utc_clock 使用 1970 年 1 月 1 日是為了與 std::chrono::system_clock 保持一致。