std::chrono::system_clock

 

C++

コンパイラサポート

フリースタンディングとホスト

言語

標準ライブラリ

標準ライブラリヘッダー

名前付き要件

機能テストマクロ (C++20)

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

メモリ管理ライブラリ

メタプログラミングライブラリ (C++11)

汎用ユーティリティライブラリ

コンテナライブラリ

イテレータライブラリ

Rangesライブラリ (C++20)

アルゴリズムライブラリ

文字列ライブラリ

テキスト処理ライブラリ

数値ライブラリ

日付と時刻ライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

並行サポートライブラリ (C++11)

実行制御ライブラリ (C++26)

Technical specifications (技術仕様)

シンボルインデックス

外部ライブラリ

 

日付と時刻ライブラリ

時間点 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日木曜日午前0時0分0秒からの時間、うるう秒は含まない）を使用しています。	(C++20まで)
system_clockはUnix時間（つまり、協定世界時 (UTC) 1970年1月1日木曜日午前0時0分0秒からの時間、うるう秒は含まない）を測定します。	(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 [static]

ticks の間の時間が常に一定である場合は true、つまり now() の呼び出しが、外部クロック調整の場合でも常に増加する値を返す場合は false。 (公開静的メンバ定数)

メンバー関数

now [static]	現在の時間点を表す std::chrono::time_point を返します。 (public static member function)
to_time_t [static]	システムクロックの時刻を std::time_t に変換します。 (public static member function)
from_time_t [static]	std::time_t をシステムクロックの時刻に変換します。 (public static member function)

注釈

system_clockの時間値は、オペレーティングシステムによっていつでも内部的に調整される可能性があります。たとえば、NTP同期やユーザーによるシステムクロックの変更などです。ただし、協定世界時 (UTC) タイムゾーンに基づいているため、夏時間やタイムゾーンの変更は影響しません。

関連

steady_clock (C++11)	調整されることのない単調増加クロック (クラス)
high_resolution_clock (C++11)	利用可能な最も短いティック周期を持つクロック (クラス)