formatter.md

formatter

• chrono[meta header]
• std[meta namespace]
• class[meta id-type]
• cpp20[meta cpp]

namespace std {
  template <class Duration, class charT>
  struct formatter<chrono::local-time-format-t<Duration>, charT>;
}

概要

local-time-format-tクラスに対するstd::formatterクラステンプレートの特殊化。

formatter::format()関数に渡されるlocal-time-format-t<Duration>型の変数fがあるとして、

• %Z (タイムゾーンの略称) が指定された場合、f.abbrevがヌルポインタでなければ*f.abbrevで置き換えられる。%Zが指定されてf.abbrevがヌルポインタだった場合、std::format_error例外が送出される
• %zもしくはその改良コマンドが指定された場合、f.offset_secがヌルポインタでなければ*f.offset_secがフォーマットされる。%zもしくはその改良コマンドが指定されてf.offset_secがヌルポインタだった場合、std::format_error例外が送出される

例

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

namespace chrono = std::chrono;

int main()
{
  auto now = chrono::system_clock::now();
  chrono::sys_seconds now_sec = chrono::floor<chrono::seconds>(now); // 秒単位

  chrono::zoned_time zt{"Asia/Tokyo", now_sec};
  std::cout << std::format("{:%Y/%m/%d %H:%M:%S %Z}", zt) << std::endl;

  auto lt = zt.get_local_time();
  chrono::sys_info si = zt.get_info();
  {
    auto ltf = chrono::local_time_format(lt, &si.abbrev);
    std::cout << std::format("{:%Y/%m/%d %H:%M:%S %Z}", ltf) << std::endl;
  }
  {
    auto ltf = chrono::local_time_format(lt, "JST", &si.abbrev, &si.offset);
    std::cout << std::format("{:%Y/%m/%d %H:%M:%S %Z%z}", ltf) << std::endl;
  }
}

• chrono::system_clock[link /reference/chrono/system_clock.md]
• now()[link /reference/chrono/system_clock/now.md]
• chrono::floor[link /reference/chrono/time_point/floor.md]
• chrono::sys_seconds[link /reference/chrono/sys_time.md]
• std::format[link /reference/chrono/format.md]
• chrono::zoned_time[link /reference/chrono/zoned_time.md]
• zt.get_local_time()[link /reference/chrono/zoned_time/get_local_time.md]
• zt.get_info()[link /reference/chrono/zoned_time/get_info.md]
• chrono::sys_info[link /reference/chrono/sys_info.md]
• chrono::local_time_format[link /reference/chrono/local_time_format.md]

出力例

2019/12/20 19:05:05 JST
2019/12/20 19:05:05 JST
2019/12/20 19:05:05 JST+0900

バージョン

言語

• C++20

処理系

• Clang: (9.0時点で実装なし)
• GCC: (9.2時点で実装なし)
• Visual C++: (2019 Update 3時点で実装なし)