std:: formatter <std::chrono::duration>

std::formatter の特殊化であり、 std::chrono::duration の書式設定規則を定義します。 duration は深夜からの時刻として解釈されます。

std::formatter の特殊化は通常直接アクセスされることはなく、 フォーマット関数 を通じて使用されます。

フォーマット仕様

書式指定は次の形式を持ちます

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 ( ) をコピーして出力バッファに書き込み、フォーマット指定子に従った追加のパディングと調整を行います。

以下のフォーマット指定子が利用可能です:

以下の指定子は認識されますが、 std::format_error をスローする原因となります：

例

#include <chrono>
#include <print>
using namespace std::chrono_literals;
int main()
{
    auto du{3h + 2min + 1s};
    std::print(
        "Duration is:\n"
        "{}\n"
        "{:%T}\n"
        "{:%H:%M:%S}\n"
        "{:%H hours %M minutes %S seconds}\n",
        du, du, du, du);
}

Duration is:
10921s
03:02:01
03:02:01
03 hours 02 minutes 01 seconds

関連項目