std::chrono::system_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::system_clock

成員函式

system_clock::now

system_clock::to_time_t

system_clock::from_time_t

時間點 I/O

operator<<

formatter<std::chrono::sys_time>

from_stream

 

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

類std::chrono::system_clock表示系統範圍內的即時掛鐘。

它可能不是單調的：在大多數系統上，系統時間可以隨時調整。它是唯一能夠將其時間點對映到 C 風格時間的 C++ 時鐘。

std::chrono::system_clock滿足TrivialClock的要求。

system_clock的紀元未指定，但大多數實現使用 Unix 時間（即自協調世界時 (UTC) 1970 年 1 月 1 日星期四 00:00:00 以來的時間，不計閏秒）。	(C++20 前)
system_clock測量 Unix 時間（即自協調世界時 (UTC) 1970 年 1 月 1 日星期四 00:00:00 以來的時間，不計閏秒）。	(C++20 起)

時間點家族

定義在名稱空間 std::chrono 中
template<class Duration> using sys_time = std::chrono::time_point<std::chrono::system_clock, Duration>;		(C++20 起)
using sys_seconds = sys_time<std::chrono::seconds>;		(C++20 起)
using sys_days = sys_time<std::chrono::days>;		(C++20 起)

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

成員型別

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

成員常量

constexpr bool is_steady [靜態]

如果兩次嘀嗒之間的時間始終恆定，即對now()的呼叫返回單調遞增的值，即使在某些外部時鐘調整的情況下也是如此，則為true，否則為false (public static 成員常量)

成員函式

now [靜態]	返回表示當前時間點的 std::chrono::time_point (public static 成員函式)
to_time_t [靜態]	將系統時鐘時間點轉換為std::time_t (public static 成員函式)
from_time_t [靜態]	將std::time_t轉換為系統時鐘時間點 (public static 成員函式)

注意

system_clock的時間值可由作業系統隨時在內部調整，例如由於 NTP 同步或使用者更改系統時鐘。然而，夏令時和時區更改不會影響它，因為它基於UTC時區。

另請參閱

steady_clock (C++11)	永不調整的單調時鐘 (類)
high_resolution_clock (C++11)	可用最短滴答週期的時鐘 (類)