std:: formatter <std::chrono::year_month>
|
ヘッダーで定義
<chrono>
|
||
|
template
<
class
CharT
>
struct formatter < std:: chrono :: year_month , CharT > ; |
(C++20以降) | |
std::formatter の特殊化で、 std::chrono::year_month のフォーマット規則を定義します。
std::formatter の特殊化は通常直接アクセスされることはなく、 フォーマット関数 を通じて使用されます。
目次 |
フォーマット仕様
書式指定は次の形式を持ちます
fill-and-align
(オプション)
width
(オプション)
precision
(オプション)
L
(オプション)
chrono-spec
(オプション)
|
|||||||||
fill-and-align
、
width
、および
precision
は、
標準フォーマット仕様
と同じ意味を持ちます。
precision
は、表現型
Rep
が浮動小数点型である
std::chrono::duration
型に対してのみ有効であり、それ以外の場合
std::format_error
がスローされます。
書式設定に使用されるロケールは以下のように決定されます：
-
フォーマット指定に
Lが存在しない場合、デフォルトの "C" ロケール、 - それ以外の場合、フォーマット関数に渡された std::locale で示されるロケール（存在する場合）、
-
それ以外の場合（
Lが存在するがフォーマット関数に std::locale が渡されていない場合）、グローバルロケール。
もし (通常またはワイド) 文字列リテラルエンコーディング がUnicodeエンコーディング形式であり、かつロケールが実装定義のロケールセットに含まれる場合、ロケールに依存する各置換は、置換文字シーケンスがリテラルエンコーディングに変換されたかのように実行されます。
chrono-spec
は1つ以上の変換指定子と通常文字（
{
、
}
、および
%
以外）で構成されます。
chrono-spec
は変換指定子で始まる必要があります。すべての通常文字は変更なしで出力に書き込まれます。各変換指定子は
%
文字で始まり、その後に指定子の動作を決定する文字が続きます。一部の変換指定子には、
%
文字の後に
E
または
O
修飾文字が挿入される修正形式があります。各変換指定子は、以下に説明するように出力で適切な文字に置き換えられます。
特に指定がない限り、
chrono-spec
が空の場合、chronoオブジェクトは
ストリーミング
によって、型
std::
basic_ostringstream
<
CharT
>
のオブジェクト
os
に、フォーマットロケール（
std::
locale
::
classic
(
)
、渡された
std::locale
オブジェクト、および
std::
locale
::
global
(
)
）のいずれかで
設定された
状態でフォーマットされ、
os.
str
(
)
が出力バッファにコピーされ、フォーマット指定子に応じた追加のパディングと調整が行われます。
以下のフォーマット指定子が利用可能です：
|
変換指定子
|
説明 | |
|---|---|---|
%%
|
リテラルの
%
文字を書き込む。
|
|
%n
|
改行文字を書き込む。 | |
%t
|
水平タブ文字を書き込む。 | |
| 年 | ||
%C
%EC
|
年を100で除算した値を床除算で書き込む。結果が1桁の場合は0で前置する。
修正指定子
|
|
%y
%Oy
%Ey
|
年の下2桁を10進数で書き込む。結果が1桁の場合は0で前置する。
修正指定子
修正指定子
|
|
%Y
%EY
|
年を10進数で書き込む。結果が4桁未満の場合は0で左埋めして4桁にする。
修正指定子
|
|
| 月 | ||
%b
%h
|
ロケールの省略月名を書き込む。 | |
%B
|
ロケールの完全月名を書き込む。 | |
%m
%Om
|
月を10進数で書き込む（1月は
01
）。結果が1桁の場合は0で前置する。
修正指定子
|
|
以下の指定子は認識されますが、 std::format_error をスローする原因となります：
| 変換指定子 | 説明 | |
|---|---|---|
| 日 | ||
%d
%Od
|
日を10進数で出力します。結果が1桁の場合、0でパディングされます。
修正コマンド
|
|
%e
%Oe
|
日を10進数で出力します。結果が1桁の場合、スペースでパディングされます。
修正コマンド
|
|
| 曜日 | ||
%a
|
ロケールの省略された曜日名を出力します。 | |
%A
|
ロケールの完全な曜日名を出力します。 | |
%u
%Ou
|
ISO 曜日を10進数（1-7）で出力します。月曜日は
1
です。
修正コマンド
|
|
%w
%Ow
|
曜日を10進数（0-6）で出力します。日曜日は
0
です。
修正コマンド
|
|
| ISO 8601 週ベースの年 | ||
|
ISO 8601では週は月曜日から始まり、年の最初の週は以下の要件を満たす必要があります：
|
||
%g
|
ISO 8601 週ベースの年の下2桁を10進数で出力します。結果が1桁の場合、0でパディングされます。 | |
%G
|
ISO 8601 週ベースの年を10進数で出力します。結果が4桁未満の場合、0で左パディングされて4桁になります。 | |
%V
%OV
|
ISO 8601 週番号を10進数で出力します。結果が1桁の場合、0でパディングされます。
修正コマンド
|
|
| 週/年の日 | ||
%j
|
年の日を10進数で出力します（1月1日は
001
）。結果が3桁未満の場合、0で左パディングされて3桁になります。
|
|
%U
%OU
|
年の週番号を10進数で出力します。年の最初の日曜日が週01の最初の日です。それ以前の同じ年の日は週00です。結果が1桁の場合、0でパディングされます。
修正コマンド
|
|
%W
%OW
|
年の週番号を10進数で出力します。年の最初の月曜日が週01の最初の日です。それ以前の同じ年の日は週00です。結果が1桁の場合、0でパディングされます。
修正コマンド
|
|
| 日付 | ||
%D
|
"%m/%d/%y"
と等価です。
|
|
%F
|
"%Y-%m-%d"
と等価です。
|
|
%x
%Ex
|
ロケールの日付表現を出力します。
修正コマンド
|
|
| 時刻 | ||
%H
%OH
|
時（24時間制）を10進数で出力します。結果が1桁の場合、0でパディングされます。
修正コマンド
|
|
%I
%OI
|
時（12時間制）を10進数で出力します。結果が1桁の場合、0でパディングされます。
修正コマンド
|
|
%M
%OM
|
分を10進数で出力します。結果が1桁の場合、0でパディングされます。
修正コマンド
|
|
%S
%OS
|
秒を10進数で出力します。秒数が10未満の場合、結果は0でパディングされます。
入力の精度が秒で正確に表現できない場合、フォーマットは固定形式の10進浮動小数点数で、入力の精度に一致する精度（または18桁の小数部以内で10進浮動小数点数秒への変換ができない場合はマイクロ秒精度）になります。小数点の文字はロケールに従ってローカライズされます。
修正コマンド
|
|
%p
|
12時間制に関連するAM/PM表示のロケール相当表現を出力します。 | |
%R
|
"%H:%M"
と等価です。
|
|
%T
|
"%H:%M:%S"
と等価です。
|
|
%r
|
ロケールの12時間制時刻を出力します。 | |
%X
%EX
|
ロケールの時刻表現を出力します。
修正コマンド
|
|
| 期間カウント | ||
%Q
|
期間のティック数を出力します。つまり、 count() で取得される値です。 | |
%q
|
期間の単位サフィックスを出力します。 operator<<() で指定された通りです。 | |
| タイムゾーン | ||
%z
%Ez
%Oz
|
UTCからのオフセットをISO 8601形式で出力します。例えば
-0430
はUTCより4時間30分遅れていることを示します。オフセットがゼロの場合、
+0000
が使用されます。
修正コマンド
|
|
%Z
|
タイムゾーンの略称を出力します。 | |
| その他 | ||
%c
%Ec
|
ロケールの日付と時刻の表現を出力します。
修正コマンド
|
|
例
|
このセクションは不完全です
理由: 例がありません |
不具合報告
以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。
| DR | 適用対象 | 公開時の動作 | 正しい動作 |
|---|---|---|---|
| P2372R3 | C++20 |
formatter
はグローバルロケールまたは渡されたロケールを使用
|
L
が存在しない場合、デフォルトの
"C"
ロケールが使用される
|
関連項目
|
(C++20)
|
引数のフォーマットされた表現を新しい文字列に格納する
(関数テンプレート) |