std:: formatter <std::chrono::utc_time>

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

• 如果使用了 %Z ，它将被替换为 "UTC" 并扩展为 CharT 类型。
• 如果使用了 %z 或其修改变体，将格式化 0min 的偏移量。
• 如果参数表示闰秒插入期间的时间且格式化了秒数字段，则该字段的整数部分为 "60" 并扩展为 CharT 类型。

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 由一个或多个转换说明符和普通字符（除 { 、 } 和 % 外）组成。 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++ 标准。

参见