std::formatter<std::chrono::gps_time>

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

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

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

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

言語サポート 型サポート (基本型、RTTI、型特性) ライブラリの機能テストマクロ (C++20) 動的メモリ管理 プログラムユーティリティ エラー処理 コルーチンサポート(C++20) 可変長引数関数 launder (C++17) initializer_list (C++11) source_location (C++20) 三方比較 (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20) is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

汎用ユーティリティ 日付と時間 関数オブジェクト 書式化ライブラリ(C++20) bitset hash (C++11) integer_sequence (C++14) 関係演算子 (C++20で非推奨) rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>= 整数比較関数 cmp_equalcmp_not_equalcmp_lesscmp_greatercmp_less_thancmp_greater_than (C++20)(C++20)(C++20)(C++20)(C++20)(C++20) in_range (C++20) スワップと型操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) forward (C++11) move (C++11) move_if_noexcept (C++11) as_const (C++17) 一般的な語彙の型 pair tuple (C++11) apply (C++17) make_from_tuple (C++17) optional (C++17) any (C++17) variant (C++17) 初等文字列変換 to_chars (C++17) from_chars (C++17) chars_format (C++17)

 

日付と時間のユーティリティ

duration (C++11) time_point (C++11)	clock_time_conversion (C++20) clock_cast (C++20)
時刻
hh_mm_ss (C++20)	is_amis_pmmake12make24 (C++20)(C++20)(C++20)(C++20)
時計
system_clock (C++11) steady_clock (C++11) high_resolution_clock (C++11) is_clock (C++20)	utc_clock (C++20) tai_clock (C++20) gps_clock (C++20) file_clock (C++20) local_t (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)
タイムゾーン
tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20)	time_zone (C++20) locate_zone (C++20) current_zone (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20)
C スタイルの日付と時間

 

std::chrono::gps_clock

メンバ関数

gps_clock::now

gps_clock::to_utc

gps_clock::from_utc

time_point の入出力

operator<<

formatter<std::chrono::gps_time>

from_stream

 

ヘッダ <chrono> で定義
template<class Duration, class CharT> struct formatter<std::chrono::gps_time<Duration>, CharT>;

std::chrono::gps_time のための書式化ルールを定義する std::formatter の特殊化です。

%Z が使用された場合は、それは CharT に拡張された "GPS" に置き換えられます。 %z またはその修飾版が使用された場合は、 0min のオフセットが書式化されます。 書式化された日付時刻は std::chrono::sys_time<Duration>(tp.time_since_epoch())+ std::chrono::days(3657) で初期化された std::chrono::sys_time に対して書式化されたそれと同等です。

std::formatter の特殊化は、通常、直接アクセスされず、書式化関数を通して使用されます。

書式指定

書式指定は以下の形式を持ちます。

fill-and-align(オプション)width(オプション)precision(オプション)chrono-spec(オプション)

fill-and-align、 width、および precision は標準の書式指定と同じ意味を持ちます。 precision は表現型 Rep が浮動小数点型である std​::​chrono​::​duration に対してのみ有効であり、そうでなければ std::format_error が投げられます。

chrono-spec は0個以上の変換指定子と ({ 、 } および % 以外の) 普通の文字から構成されます。 普通の文字はすべて変更されずに出力に書き込まれます。 修飾されていない変換指定子は % 文字で始まり指定子の動作を決定する文字が続きます。 一部の変換指定子は % の後に修飾文字 E または O が挿入された修飾形式を持ちます。 変換指定は後述のように出力中に適切な文字で置き換えられます。

% で始まるけれども以下の書式指定子のいずれにもマッチしない書式文字列内の文字の並びは普通の文字として解釈されます。

chrono-spec が空の場合は、 chrono オブジェクトは、それを std::stringstream os にストリームして os.str() に書式指定通りにパディングを追加した後それを出力バッファにコピーしたかのように、書式化されます。

以下の書式指定子が利用可能です。

変換指定子	説明
%%	文字 % を書き込みます。
%n	改行文字を書き込みます。
%t	水平タブ文字を書き込みます。
年
%C %EC	切り捨て除算を使用して100で割った年を書き込みます。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %EC はロケールの世紀の代替表現を書き込みます。
%y	年の下2桁を書き込みます。 結果が1桁の場合は前に0が付加されます。
%Y	年を10進数として書き込みます。 結果が4桁未満の場合は4桁になるまで前に0が付加されます。
月
%b %h	ロケールの省略形の月名を書き込みます。
%B	ロケールの完全形の月名を書き込みます。
%m %Om	月を10進数として書き込みます (1月が 01 です)。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %Om はロケールの代替表現を書き込みます。
日
%d %Od	日を10進数として書き込みます。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %Od はロケールの代替表現を書き込みます。
%e %Oe	日を10進数として書き込みます。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %Oe はロケールの代替表現を書き込みます。
曜日
%a	ロケールの省略形の曜日名を書き込みます。
%A	ロケールの完全形の曜日名を書き込みます。
%u %Ou	ISO の曜日を10進数 (1〜7) として書き込みます。 月曜日が 1 です。 修飾付きのコマンド %Ou はロケールの代替表現を書き込みます。
%w %Ow	曜日を10進数 (0〜6) として書き込みます。 日曜日が 0 です。 修飾付きのコマンド %Ow はロケールの代替表現を書き込みます。
ISO 8601 の週基準の年
ISO 8601 では、週は月曜日から始まり、年の最初の週は、以下の要件を満たさなければなりません。 1月4日を含む その年の最初の木曜日を含む
%g	ISO 8601 の週基準の年の下2桁を書き込みます。 結果が1桁の場合は前に0が付加されます。
%G	ISO 8601 の週基準の年を10進数として書き込みます。 結果が4桁未満の場合は4桁になるまで前に0が付加されます。
%V %OV	ISO 8601 の週番号を10進数として書き込みます。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %OV はロケールの代替表現を書き込みます。
週番号および通日
%j	通日を10進数として書き込みます (1月1日が 001 です)。 結果が3桁未満の場合は3桁になるまで前に0が付加されます。
%U %OU	週番号を10進数として書き込みます。 その年の最初の日曜日が週番号01の最初の日です。 同じ年のそれより前の日は週番号00です。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %OU はロケールの代替表現を書き込みます。
%W %OW	週番号を10進数として書き込みます。 その年の最初の月曜日が週番号01の最初の日です。 同じ年のそれより前の日は週番号00です。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %OW はロケールの代替表現を書き込みます。
日付
%D	"%m/%d/%y" と同等です。
%F	"%Y-%m-%d" と同等です。
%x %Ex	ロケールの日付表現を書き込みます。 修飾付きのコマンド %Ex はロケールの代替日付表現を書き込みます。
時刻
%H %OH	時 (24時間表記) を10進数として書き込みます。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %OH はロケールの代替表現を書き込みます。
%I %OI	時 (12時間表記) を10進数として書き込みます。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %OI はロケールの代替表現を書き込みます。
%M %OM	分を10進数として書き込みます。 結果が1桁の場合は前に0が付加されます。 修飾付きのコマンド %OM はロケールの代替表現を書き込みます。
%S %OS	秒を10進数として書き込みます。 秒数が10未満の場合は前に0が付加されます。 入力の精度が正確に秒で表せない場合は、書式は入力の精度にマッチする精度 (または、浮動小数点の10進数の秒への変換が小数点以下18桁以内で行えない場合はマイクロ秒の精度) を持つ固定小数点表記の10進浮動小数点数になります。 小数点の文字はロケールに従ってローカライズされます。 修飾付きのコマンド %OS はロケールの代替表現を書き込みます。
%p	午前/午後に相当するロケールの表現を書き込みます。
%R	"%H:%M" と同等です。
%T	"%H:%M:%S" と同等です。
%r	ロケールの12時間表記の時刻表現を書き込みます。
%X %EX	ロケールの時刻表現を書き込みます。 修飾付きのコマンド %EX はロケールの代替時刻表現を書き込みます。
その他
%c %Ec	ロケールの日付時刻表現を書き込みます。 修飾付きのコマンド %Ec はロケールの代替日付時刻表現を書き込みます。
%z %Ez %Oz	UTC からのオフセットを ISO 8601 形式で書き込みます。 例えば -0430 は UTC より4時間30分遅れていることを表します。 オフセットがゼロの場合は +0000 が使用されます。 修飾付きのコマンド %Ez および %Oz は時と分の間に : を挿入します (例えば -04:30)。
%Z	タイムゾーンの省略形を書き込みます。

関連項目

format (C++20)

引数の書式化された表現を新しい文字列に格納します (関数テンプレート)