std:: formatter <std::chrono::year_month_day>
|
ヘッダーで定義
<chrono>
|
||
|
template
<
class
CharT
>
struct formatter < std:: chrono :: year_month_day , CharT > ; |
(C++20以降) | |
std::formatter の特殊化で、 std::chrono::year_month_day の書式設定ルールを定義します。
std::formatter の特殊化は通常直接アクセスされることはなく、 フォーマット関数 を通じて使用されます。
フォーマット仕様
書式指定は次の形式を持ちます
fill-and-align
(オプション)
width
(オプション)
precision
(オプション)
L
(オプション)
chrono-spec
(オプション)
|
|||||||||
fill-and-align
、
width
、および
precision
は、
標準フォーマット仕様
と同じ意味を持ちます。
precision
は、
std::chrono::duration
型のうち、表現型
Rep
が浮動小数点型である場合にのみ有効です。それ以外の場合は、
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
(
)
を出力バッファにコピーし、フォーマット指定子に従った追加のパディングと調整を行うかのようにフォーマットされます。
以下のフォーマット指定子が利用可能です:
|
変換指定子
specifier |
説明 | |
|---|---|---|
%%
|
リテラルの
%
文字を書き込む
|
|
%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で前置する
修正指定子
|
|
| 日 | ||
%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では週は月曜日から始まり、年の第1週は以下の要件を満たす必要がある：
|
||
%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
|
ロケールの日付表現を書き込む
修正指定子
|
|
以下の指定子は認識されますが、 std::format_error をスローする原因となります：
|
変換指定子
specifier |
説明 | |
|---|---|---|
| 時刻 | ||
%H
%OH
|
時間（24時間制）を10進数で書き出す。結果が1桁の場合、0が前置される。
修正コマンド
|
|
%I
%OI
|
時間（12時間制）を10進数で書き出す。結果が1桁の場合、0が前置される。
修正コマンド
|
|
%M
%OM
|
分を10進数で書き出す。結果が1桁の場合、0が前置される。
修正コマンド
|
|
%S
%OS
|
秒を10進数で書き出す。秒数が10未満の場合、結果には0が前置される。
入力の精度が秒で正確に表現できない場合、形式は固定形式の10進浮動小数点数となり、精度は入力の精度に一致する（または、浮動小数点10進秒への変換が18桁の小数部以内で行えない場合はマイクロ秒精度まで）。小数点の文字はロケールに従ってローカライズされる。
修正コマンド
|
|
%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++20)
|
引数のフォーマットされた表現を新しい文字列に格納する
(関数テンプレート) |