std:: formatter <std::chrono::sys_time>

针对 std::formatter 的特化，用于定义 std::chrono::sys_time 的格式化规则。

• 如果使用了 %Z ，它将被替换为 "UTC" 并扩展为 CharT 类型。
• 如果使用了 %z 或其修改变体，将格式化 0min 的偏移量。

std::formatter 的特化通常不直接访问，而是通过 格式化函数 使用。

格式规范

格式规范具有以下形式

fill-and-align 、 width 和 precision 的含义与 标准格式规范 中的定义相同。 precision 仅当 std::chrono::duration 类型的表示类型 Rep 为浮点类型时有效，否则将抛出 std::format_error 。

用于格式化的区域设置按以下方式确定：

• 若格式规范中不存在 L ，则使用默认的 "C" 区域设置，
• 否则，使用传递给格式化函数的 std::locale 所指示的区域设置（若存在），
• 否则（存在 L 但未向格式化函数传递 std::locale ），则使用全局区域设置。

如果 （普通或宽）字符串字面值编码 是Unicode编码形式且区域设置属于实现定义的区域设置集合，则每个依赖于区域设置的替换操作会如同将替换字符序列转换为字面值编码般执行。

chrono-spec 由一个或多个转换说明符和普通字符（除 { 、 } 和 % 外）组成。 chrono-spec 必须以转换说明符开头。所有普通字符均会不经修改地写入输出。每个未修改的转换说明符以 % 字符开头，后接一个决定说明符行为的字符。部分转换说明符具有修改形式，即在 % 字符后插入 E 或 O 修饰符字符。如下所述，每个转换说明符将被输出中的相应字符替换。

除非另有说明，若 chrono-spec 为空，则时间对象的格式化方式等同于将其 流式输出 到类型为 std:: basic_ostringstream < CharT > 的对象 os ，该对象需植入格式化区域设置（可为 std:: locale :: classic ( ) 、传入的 std::locale 对象或 std:: locale :: global ( ) 之一），随后将 os. str ( ) 复制到输出缓冲区，并根据格式说明符进行额外填充和对齐调整。

以下格式说明符可用：

以下标识符可被识别，但会导致抛出 std::format_error ：

示例

#include <chrono>
#include <format>
#include <iostream>
int main()
{
    std::chrono::time_point<std::chrono::utc_clock> epoch;
    std::cout << std::format("The time of the Unix epoch was {0:%F}T{0:%R%z}.", epoch)
              << '\n';
}

The time of the Unix epoch was 1970-01-01T00:00+0000.

缺陷报告

以下行为变更缺陷报告被追溯应用于先前发布的C++标准。

参见