日期與時間函式庫

 

C++

編譯器支援

獨立式與託管式

語言

標準函式庫

標準函式庫標頭檔

具名要求

特性測試巨集 (C++20)

語言支援函式庫

概念函式庫 (C++20)

診斷函式庫

記憶體管理函式庫

元編程函式庫 (C++11)

通用公用程式函式庫

容器函式庫

疊代器函式庫

Ranges 函式庫 (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

• 時鐘 (clocks)
• 時間點 (time points)
• 時間段 (durations)

曆法 (calendar) 日期 時區 (time zone) 資訊

(自 C++20 起)

時鐘

時鐘由起始點（紀元，epoch）和計時頻率（tick rate）組成。例如，時鐘的紀元可以是 1970 年 1 月 1 日，並每秒計數一次。C++ 定義了多種時鐘型別

定義於標頭檔 <chrono>
定義於命名空間 std::chrono
system_clock (C++11)	來自系統全域即時時鐘的牆面時鐘時間 (class)
steady_clock (C++11)	永不調整的單調時鐘 (class)
high_resolution_clock (C++11)	具有最短刻度週期的可用時鐘 (class)
is_clockis_clock_v (C++20)	判斷一個型別是否為 Clock (class template) (variable template)
utc_clock (C++20)	用於協調世界時 (UTC) 的 Clock (類別)
tai_clock (C++20)	用於國際原子時 (TAI) 的 Clock (類別)
gps_clock (C++20)	用於 GPS 時間的 Clock (類別)
file_clock (C++20)	用於檔案時間的時鐘 (typedef)
local_t (C++20)	代表當地時間的偽時鐘 (pseudo-clock) (類別)

時間點

時間點是自特定時鐘的紀元起經過的時間段。

定義於標頭檔 <chrono>
定義於命名空間 std::chrono
time_point (C++11)	時間上的一個點 (類別模板)
clock_time_conversion (C++20)	定義如何將一個時鐘的時間點轉換為另一個時鐘的時間點的特性類別 (class template)
clock_cast (C++20)	將一個時鐘的時間點轉換為另一個時鐘的時間點 (function template)

時間段

時間段由一段時間長度組成，定義為某個時間單位的計數值。例如，「42 秒」可以表示為一個包含 42 個 1 秒時間單位計數的時間段。

定義於標頭檔 <chrono>
定義於命名空間 std::chrono
duration (C++11)	一個時間區間 (class template)

時刻 (自 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 (class)
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)	表示某個特定年份、月份和日期 (class)
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)	格里曆日期建立的慣用語法 (function)

時區 (自 C++20 起)

定義於標頭檔 <chrono>
定義於命名空間 std::chrono
tzdb (C++20)	描述一份 IANA 時區資料庫 的副本 (類別)
tzdb_list (C++20)	表示 tzdb 的連結串列 (類別)
get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)	存取與控制全域時區資料庫資訊 (function)
locate_zone (C++20)	根據名稱定位一個 time_zone (函式)
current_zone (C++20)	返回當前的 time_zone (函式)
time_zone (C++20)	表示一個時區 (class)
sys_info (C++20)	表示關於特定時間點的時區資訊 (類別)
local_info (C++20)	表示關於當地時間轉換為 UNIX 時間的資訊 (類別)
choose (C++20)	選擇應如何解決模稜兩可的當地時間 (列舉)
zoned_traits (C++20)	用於 zoned_time 的時區指標的特徵類別 (traits class) (類別模板)
zoned_time (C++20)	表示一個時區和一個時間點 (class)
leap_second (C++20)	包含關於閏秒插入的資訊 (class)
leap_second_info (C++20)	閏秒插入資訊 (class)
get_leap_second_info (C++20)	從 utc_time 物件取得閏秒插入資訊 (function template)
time_zone_link (C++20)	表示時區的別名 (類別)
nonexistent_local_time (C++20)	拋出異常以報告本地時間不存在 (class)
ambiguous_local_time (C++20)	拋出異常以報告本地時間不明確 (class)

字面量 (自 C++14 起)

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

Chrono 輸入輸出 (自 C++20 起)

定義於標頭檔 <chrono>
定義於命名空間 std::chrono
parse (C++20)	從資料流中解析 chrono 物件 (function template)

註記

功能測試巨集	數值	標準	功能
__cpp_lib_chrono	201510L	(C++17)	用於 std::chrono::duration 與 std::chrono::time_point 的捨入 (Rounding) 函式
	201611L	(C++17)	constexpr 用於 std::chrono::duration 與 std::chrono::time_point 的所有成員函式
	201907L	(C++20)	曆法與時區
	202306L	(C++26)	std::chrono 值類別的 雜湊 (Hashing) 支援

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