std::chrono::format

 

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 スタイルの日付と時間

 

template<class CharT, class Streamable> std::basic_string<CharT> format(const CharT* fmt, const Streamable& s);	(1)	(C++20以上)
template<class CharT, class Streamable> std::basic_string<CharT> format(conststd::locale& loc, const CharT* fmt, const Streamable& s);	(2)	(C++20以上)
template<class CharT, class Traits, class Alloc, class Streamable> std::basic_string<CharT, Traits, Alloc> format(conststd::basic_string<CharT, Traits, Alloc>& fmt,                                                const Streamable& s);	(3)	(C++20以上)
template<class CharT, class Traits, class Alloc, class Streamable> std::basic_string<CharT, Traits, Alloc> format(conststd::locale& loc,                                                conststd::basic_string<CharT, Traits, Alloc>& fmt,                                                const Streamable& s);	(4)	(C++20以上)

書式文字列 fmt およびロケール loc (指定された場合) を使用して、ストリーム可能なオブジェクト s をフォーマットします。

これらの関数テンプレートは以下のように行われたかのように動作します。

• std::basic_ostringstream<CharT, Traits, Alloc>os を構築します ((1,2) の場合、 Traits は std::char_traits<CharT>、 Alloc は std::allocator<CharT> になります)。
• os.exceptions(std::ios_base::failbit|std::ios_base::badbit) を実行します。
• os.imbue(loc) を呼びます (オーバーロード (2,4) の場合のみ)。
• to_stream(os, fmt, s) ((1,2) の場合) または to_stream(os, fmt.c_str(), s) ((3,4) の場合) を呼びます。 ただし to_stream は実引数依存の名前探索を有効にするため非修飾で呼ばれます。
• そして os.str() を返します。

1-2) これらのオーバーロードは、to_stream(std::declval<std::basic_ostream<CharT>&>(), fmt, s) が有効な式である場合にのみ、オーバーロード解決に参加します.

3-4) これらのオーバーロードは、to_stream(std::declval<std::basic_ostringstream<CharT, Traits, Alloc>&>(), fmt.c_str(), s) が有効な式である場合にのみ、オーバーロード解決に参加します.

書式文字列

書式文字列は0個以上の変換指定子および通常の文字から構成されます。 通常の文字は、終端のヌル文字を除き、変更されずに出力ストリームに書き込まれます。 無修飾の変換指定子は % 文字で始まり、その後に指定子の動作を決める文字が続きます。 変換指定子には、 % 文字の後に修飾文字 E または O が挿入される、修飾付きの形式を持つものもあります。 各変換指定子は、以下で説明するように、適切な文字列に置き換えて出力されます。

書式文字列中の、 % で始まるけれども以下の変換指定子のいずれにも一致しない文字シーケンスは、通常の文字として解釈されます。

以下の変換指定子が利用できます。

変換指定子	説明
%%	% 文字を書き込みます。
%n	改行文字を書き込みます。
%t	水平タブ文字を書き込みます。
年
%C %EC	年を100で割って切り捨てた値を書き込みます。 結果が10進数1桁の場合、前に0が付加されます。 修飾付きのコマンド %EC は、ロケールの世紀の代替表現を書き込みます。
%y	年の10進数の下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桁の場合、前に空白が付加されます。 修飾付きのコマンド %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 の週基準の年の10進数の下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	タイムゾーンの省略形を書き込みます。

関連項目

to_stream (std::chrono::sys_time) (C++20)	指定された書式に従って sys_time をストリームに出力します (関数テンプレート)
to_stream (std::chrono::utc_time) (C++20)	指定された書式に従って utc_time をストリームに出力します (関数テンプレート)
to_stream (std::chrono::tai_time) (C++20)	指定された書式に従って tai_time をストリームに出力します (関数テンプレート)
to_stream (std::chrono::gps_time) (C++20)	指定された書式に従って gps_time をストリームに出力します (関数テンプレート)
to_stream (std::chrono::file_time) (C++20)	指定された書式に従って file_time をストリームに出力します (関数テンプレート)
to_stream (std::chrono::local_time) (C++20)	指定された書式に従って local_time をストリームに出力します (関数テンプレート)
to_stream	指定された書式に従って year をストリームに出力します (関数テンプレート)
to_stream	指定された書式に従って month をストリームに出力します (関数テンプレート)
to_stream	指定された書式に従って day をストリームに出力します (関数テンプレート)
to_stream	指定された書式に従って weekday をストリームに出力します (関数テンプレート)
to_stream	指定された書式に従って month_day をストリームに出力します (関数テンプレート)
to_stream	指定された書式に従って year_month をストリームに出力します (関数テンプレート)
to_stream	指定された書式に従って year_month_day をストリームに出力します (関数テンプレート)
to_stream	指定された書式に従って zoned_time をストリームに出力します (関数テンプレート)