std:: formatter <std::chrono::year_month_weekday_last>

定义于头文件 <chrono>
template < class CharT > struct formatter < std:: chrono :: year_month_weekday_last , CharT > ;		(C++20 起)

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

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

目录 1 格式规范 2 示例 3 缺陷报告 4 参见

格式规范

格式规范具有以下形式

填充与对齐  (可选) 宽度  (可选) 精度  (可选) L (可选) 时间规范  (可选)

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 ( ) 复制到输出缓冲区，同时根据格式说明符进行额外的填充和对齐调整。

以下格式说明符可用：

转换 说明符	说明
%%	写入字面量 % 字符。
%n	写入换行符。
%t	写入水平制表符。
年份
%C %EC	使用向下取整除法写入年份除以100的结果。若结果为单个十进制数字，则前缀补0。 修改命令 %EC 写入区域设置的世纪替代表示。
%y %Oy %Ey	写入年份的最后两位十进制数字。若结果为单个数字，则前缀补0。 修改命令 %Oy 写入区域设置的替代表示。 修改命令 %Ey 写入相对于 %EC 的区域设置替代偏移表示（仅年份）。
%Y %EY	以十进制数字形式写入年份。若结果不足四位数字，则左侧补0至四位。 修改命令 %EY 写入区域设置的完整年份替代表示。
月份
%b %h	写入区域设置的缩写月份名称。
%B	写入区域设置的完整月份名称。
%m %Om	以十进制数字形式写入月份（一月为 01 ）。若结果为单个数字，则前缀补0。 修改命令 %Om 写入区域设置的替代表示。
日
%d %Od	以十进制数字形式写入月份中的日。若结果为单个十进制数字，则前缀补0。 修改命令 %Od 写入区域设置的替代表示。
%e %Oe	以十进制数字形式写入月份中的日。若结果为单个十进制数字，则前缀补空格。 修改命令 %Oe 写入区域设置的替代表示。
星期
%a	写入区域设置的缩写星期名称。
%A	写入区域设置的完整星期名称。
%u %Ou	以十进制数字形式写入ISO星期（1-7），其中周一为 1 。 修改命令 %Ou 写入区域设置的替代表示。
%w %Ow	以十进制数字形式写入星期（0-6），其中周日为 0 。 修改命令 %Ow 写入区域设置的替代表示。
ISO 8601 基于周的年份
在ISO 8601标准中，周从周一开始，且年份的第一周必须满足以下要求： 包含1月4日 包含年份的第一个星期四
%g	写入ISO 8601基于周的年份的最后两位十进制数字。若结果为单个数字，则前缀补0。
%G	以十进制数字形式写入ISO 8601基于周的年份。若结果不足四位数字，则左侧补0至四位。
%V %OV	以十进制数字形式写入ISO 8601年份中的周。若结果为单个数字，则前缀补0。 修改命令 %OV 写入区域设置的替代表示。
年中的周/日
%j	以十进制数字形式写入年中的日（1月1日为 001 ）。若结果不足三位数字，则左侧补0至三位。
%U %OU	以十进制数字形式写入年中的周数。年份的第一个周日是第01周的第一天。同年中在此之前的日子属于第00周。若结果为单个数字，则前缀补0。 修改命令 %OU 写入区域设置的替代表示。
%W %OW	以十进制数字形式写入年中的周数。年份的第一个周一是第01周的第一天。同年中在此之前的日子属于第00周。若结果为单个数字，则前缀补0。 修改命令 %OW 写入区域设置的替代表示。
日期
%D	等价于 "%m/%d/%y" 。
%F	等价于 "%Y-%m-%d" 。
%x %Ex	写入区域设置的日期表示。 修改命令 %Ex 生成区域设置的替代日期表示。

以下标识符可被识别，但会引发 std::format_error 异常：

转换 说明符	说明
一天中的时间
%H %OH	将小时（24小时制）以十进制数形式写入。若结果为个位数，则前缀补0。 修改命令 %OH 写入区域设置的替代表示形式。
%I %OI	将小时（12小时制）以十进制数形式写入。若结果为个位数，则前缀补0。 修改命令 %OI 写入区域设置的替代表示形式。
%M %OM	将分钟以十进制数形式写入。若结果为个位数，则前缀补0。 修改命令 %OM 写入区域设置的替代表示形式。
%S %OS	将秒以十进制数形式写入。若秒数小于10，则结果前缀补0。 若输入的精度无法用整秒精确表示，则格式为固定格式的十进制浮点数，其精度与输入精度匹配（若转换为浮点十进制秒时无法在18位小数内完成，则使用微秒精度）。小数点字符根据区域设置进行本地化。 修改命令 %OS 写入区域设置的替代表示形式。
%p	写入与12小时制相关的AM/PM标识的区域设置等效形式。
%R	等价于 "%H:%M" 。
%T	等价于 "%H:%M:%S" 。
%r	写入区域设置的12小时制时间。
%X %EX	写入区域设置的时间表示形式。 修改命令 %EX 写入区域设置的替代时间表示形式。
时长计数
%Q	写入时长的滴答计数，即通过 count() 获得的值。
%q	写入时长的单位后缀，具体规范见 operator<<() 。
时区
%z %Ez %Oz	以ISO 8601格式写入UTC偏移量。例如 -0430 表示比UTC晚4小时30分钟。若偏移量为零，则使用 +0000 。 修改命令 %Ez 和 %Oz 在小时和分钟之间插入 : （例如 -04:30 ）。
%Z	写入时区缩写。
其他
%c %Ec	写入区域设置的日期和时间表示形式。 修改命令 %Ec 写入区域设置的替代日期和时间表示形式。

示例

本节内容不完整 原因：缺少示例

缺陷报告

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

DR	适用范围	发布时的行为	正确行为
P2372R3	C++20	formatter 使用全局区域设置或传入的区域设置	当 L 不存在时使用默认的 "C" 区域设置

参见

format (C++20)

将参数的格式化表示存储于新字符串中 (函数模板)