最終更新日時(UTC): 2025年10月19日 17時05分17秒
Raclamusi が更新

履歴 編集

class
<chrono>

# std::formatter(C++20)

    namespace std {
      template <class charT>
      struct formatter<chrono::year_month_day_last, charT>;
    }

## 概要

`year_month_day_last`クラスに対する`std::formatter`クラステンプレートの特殊化。

フォーマットフラグとしては、以下を使用できる：

フォーマットフラグ | 説明
--- | ---
`%D` | `%m/%d/%y`と等価
`%F` | `%Y-%m-%d`と等価
`%j` | 年の日 (1月1日を`001`とした経過日)
`%x` | ロケール依存の日付表現
`%Ex` | `%x`の異なる表現

その他、`day`、`month`、`year`で利用可能なフォーマットフラグを使用できる。

## 例

    #include <iostream>
    #include <chrono>
    #include <format>

    namespace chrono = std::chrono;
    using namespace std::chrono_literals;

    int main() {
      chrono::year_month_day_last date = 2020y/2/chrono::last;

      // デフォルトフォーマットはoperator<<と同じ
      std::cout << std::format("1 : {}", date) << std::endl;

      std::cout << std::format("2 : {:%D}", date) << std::endl;
      std::cout << std::format("3 : {:%F}", date) << std::endl;
      std::cout << std::format("4 : {:%x}", date) << std::endl;
      std::cout << std::format("5 : {:%Y年%m月%d日}", date) << std::endl;

      // ロケール依存の出力
      std::cout << std::format(std::locale("ja_JP.UTF-8"), "6 : {:%x}", date) << std::endl;
      std::cout << std::format(std::locale("ja_JP.UTF-8"), "7 : {:%Ex}", date) << std::endl;
    }

### 出力

    1 : 2020/Feb/last
    2 : 02/29/20
    3 : 2020-02-29
    4 : 02/29/20
    5 : 2020年02月29日
    6 : 2020年02月29日
    7 : 令和02年02月29日

## バージョン

### 言語

- C++20

### 処理系

- Clang: 9.0 ❌
- GCC: 9.2 ❌, 15.1 ✅
- Visual C++: 2019 Update 3 ❌

## 関連項目

- chronoの`std::format()` (フォーマットの詳細)