日期和時間庫

 

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風格日期和時間

 

C++ 支援兩種時間操作

• chrono 庫，一個靈活的型別集合，以不同精度（例如，std::chrono::time_point）跟蹤時間。
• C 風格日期和時間庫（例如，std::time）。

Chrono 庫 (自 C++11 起)

chrono 庫定義了幾種主要型別以及實用函式和常用 typedef

• 時鐘
• 時間點
• 時長

日曆 日期 時區 資訊

(C++20 起)

時鐘

時鐘由起始點（或紀元）和滴答速率組成。例如，時鐘可能有一個紀元是 1970 年 1 月 1 日，並且每秒滴答一次。C++ 定義了幾種時鐘型別

定義於標頭檔案 <chrono>
定義在名稱空間 std::chrono 中
system_clock (C++11)	系統範圍即時時鐘的掛鐘時間 (類)
steady_clock (C++11)	永不調整的單調時鐘 (類)
high_resolution_clock (C++11)	可用最短滴答週期的時鐘 (類)
is_clockis_clock_v (C++20)	確定一個型別是否是 時鐘 (類模板) (變數模板)
utc_clock (C++20)	用於協調世界時 (UTC) 的 時鐘 (類)
tai_clock (C++20)	用於國際原子時 (TAI) 的 時鐘 (類)
gps_clock (C++20)	用於 GPS 時間的 時鐘 (類)
file_clock (C++20)	用於 檔案時間的 時鐘 (typedef)
local_t (C++20)	表示本地時間的偽時鐘 (類)

時間點

時間點是自特定時鐘紀元以來經過的時長。

定義於標頭檔案 <chrono>
定義在名稱空間 std::chrono 中
time_point (C++11)	時間中的一個點 (類模板)
clock_time_conversion (C++20)	定義如何將一個時鐘的時間點轉換為另一個時鐘的時間點的特性類 (類模板)
clock_cast (C++20)	將一個時鐘的時間點轉換為另一個時鐘的時間點 (函式模板)

時長

時長由一段時間跨度組成，定義為某個時間單位的某個滴答數。例如，“42 秒”可以由 42 個 1 秒時間單位的滴答組成的時長表示。

定義於標頭檔案 <chrono>
定義在名稱空間 std::chrono 中
duration (C++11)	時間間隔 (類模板)

時間 (自 C++20 起)

hh_mm_ss 將表示自午夜以來經過的時間的時長拆分為小時、分鐘、秒和適用的小數秒。它主要是一個格式化工具。

定義於標頭檔案 <chrono>
定義在名稱空間 std::chrono 中
hh_mm_ss (C++20)	表示一天中的時間 (類模板)
is_amis_pmmake12make24 (C++20)	在 12 小時/24 小時格式之間轉換一天中的時間 (函式)

日曆 (自 C++20 起)

定義於標頭檔案 <chrono>
定義在名稱空間 std::chrono 中
last_spec (C++20)	表示月份中 最後一天 或最後一週日的標籤類 (類)
day (C++20)	表示月份中的一天 (類)
month (C++20)	表示年份中的一個月 (類)
year (C++20)	表示公曆中的一年 (類)
weekday (C++20)	表示公曆中的一週中的一天 (類)
weekday_indexed (C++20)	表示月份中的第 n 個 weekday (類)
weekday_last (C++20)	表示月份中的最後一個 weekday (類)
month_day (C++20)	表示特定 month 中的特定 day (類)
month_day_last (C++20)	表示特定 month 的最後一天 (類)
month_weekday (C++20)	表示特定 month 中的第 n 個 weekday (類)
month_weekday_last (C++20)	表示特定 month 中的最後一個 weekday (類)
year_month (C++20)	表示特定 year 中的特定 month (類)
year_month_day (C++20)	表示特定的 year、month 和 day (類)
year_month_day_last (C++20)	表示特定 year 和 month 的最後一天 (類)
year_month_weekday (C++20)	表示特定 year 和 month 中的第 n 個 weekday (類)
year_month_weekday_last (C++20)	表示特定 year 和 month 中的最後一個 weekday (類)
operator/ (C++20)	格里高利曆日期建立的傳統語法 (函式)

時區 (自 C++20 起)

定義於標頭檔案 <chrono>
定義在名稱空間 std::chrono 中
tzdb (C++20)	描述 IANA 時區資料庫 的副本 (類)
tzdb_list (C++20)	表示 tzdb 的連結串列 (類)
get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)	訪問和控制全域性時區資料庫資訊 (函式)
locate_zone (C++20)	根據名稱定位 time_zone (函式)
current_zone (C++20)	返回當前的 time_zone (函式)
time_zone (C++20)	表示一個時區 (類)
sys_info (C++20)	表示特定時間點關於時區的資訊 (類)
local_info (C++20)	表示有關本地時間到 UNIX 時間轉換的資訊 (類)
choose (C++20)	選擇如何解決模糊的本地時間 (列舉)
zoned_traits (C++20)	用於 zoned_time 所使用的時區指標的特性類 (類模板)
zoned_time (C++20)	表示時區和時間點 (類)
leap_second (C++20)	包含有關閏秒插入的資訊 (類)
leap_second_info (C++20)	閏秒插入資訊 (類)
get_leap_second_info (C++20)	從 utc_time 物件獲取閏秒插入資訊 (函式模板)
time_zone_link (C++20)	表示時區的別名 (類)
nonexistent_local_time (C++20)	報告本地時間不存在時丟擲的異常 (類)
ambiguous_local_time (C++20)	報告本地時間模糊時丟擲的異常 (類)

字面量 (自 C++14 起)

定義於標頭檔案 <chrono>
在內聯名稱空間 std::literals::chrono_literals 中定義
operator""y (C++20)	表示特定年份的 std::chrono::year 字面量 (函式)
operator""d (C++20)	表示月份中某天的 std::chrono::day 字面量 (函式)
operator""h (C++14)	表示小時的 std::chrono::duration 字面量 (函式)
operator""min (C++14)	表示分鐘的 std::chrono::duration 字面量 (函式)
operator""s (C++14)	表示秒的 std::chrono::duration 字面量 (函式)
operator""ms (C++14)	表示毫秒的 std::chrono::duration 字面量 (函式)
operator""us (C++14)	表示微秒的 std::chrono::duration 字面量 (函式)
operator""ns (C++14)	表示納秒的 std::chrono::duration 字面量 (函式)

Chrono I/O (自 C++20 起)

定義於標頭檔案 <chrono>
定義在名稱空間 std::chrono 中
parse (C++20)	從流解析 chrono 物件 (函式模板)

注意

特性測試宏	值	標準	特性
__cpp_lib_chrono	201510L	(C++17)	std::chrono::duration 和 std::chrono::time_point 的舍入函式
	201611L	(C++17)	constexpr 用於 std::chrono::duration 和 std::chrono::time_point 的所有成員函式
	201907L	(C++20)	日曆 和 時區
	202306L	(C++26)	對 std::chrono 值類的 雜湊 支援

C 風格日期和時間庫

還提供了 C 風格的日期和時間函式，例如 std::time_t、std::difftime 和 CLOCKS_PER_SEC。

示例

執行此程式碼

#include <chrono>
#include <iostream>
 
long Fibonacci(unsigned n)
{
    return n < 2 ? n : Fibonacci(n - 1) + Fibonacci(n - 2);
}
 
int main()
{
    // Measures and displays an execution time of a function call.
    const auto start{std::chrono::steady_clock::now()};
    const auto fb{Fibonacci(42)};
    const auto finish{std::chrono::steady_clock::now()};
    const std::chrono::duration<double> elapsed_seconds{finish - start};
 
    std::cout << "Fibonacci(42): " << fb << "\nElapsed time: ";
//  std::cout << elapsed_seconds.count() << "s\n"; // Before C++20
    std::cout << elapsed_seconds << '\n'; // C++20's chrono::duration operator<<
 
    // Prints UTC and local time.
    const auto tp_utc{std::chrono::system_clock::now()};
    std::cout << "Current time 'UTC' is: " << tp_utc << "\n"
                 "Current time 'Local' is: "
              << std::chrono::current_zone()->to_local(tp_utc) << '\n';
}

可能的輸出

Fibonacci(42): 267914296
Elapsed time: 0.728532s
Current time 'UTC' is: 2025-02-10 06:22:39.420666960
Current time 'Local' is: 2025-02-10 09:22:39.420666960