std::formatter<std::chrono::weekday>
在头文件 <chrono> 中定义 |
||
template< class CharT > struct formatter<std::chrono::weekday, CharT>; |
(自 C++20 起) | |
std::formatter
的特化,它定义了对 std::chrono::weekday
的格式化规则。
std::formatter
特化通常不会直接访问,而是通过 格式化函数 使用。
内容 |
[编辑] 格式规范
格式规范采用以下形式
填充和对齐 (可选) 宽度 (可选) 精度 (可选) L (可选) 时间规范 (可选) |
|||||||||
填充和对齐、宽度 和 精度 与 标准格式规范 中的含义相同。 精度 仅对 Rep
表示类型为浮点类型的 std::chrono::duration
类型有效,否则将抛出 std::format_error
。
用于格式化的区域设置如下确定
- 如果格式规范中不存在
L
,则为默认的 "C" 区域设置。 - 否则,为格式化函数传递的
std::locale
所表示的区域设置(如果有)。 - 否则(
L
存在,但没有将std::locale
传递给格式化函数),则为全局区域设置。
如果 (普通或宽) 字符串文字编码 是 Unicode 编码形式,并且区域设置属于实现定义的区域设置集,则每个依赖区域设置的替换都像替换字符序列被转换为文字编码一样执行。
时间规范
由一个或多个转换说明符和普通字符(除 {
、}
和 %
外)组成。时间规范
必须以转换说明符开头。所有普通字符都将写入输出而不会修改。每个未修改的转换说明符以 %
字符开头,后跟一个字符,该字符确定说明符的行为。某些转换说明符具有修改形式,其中在 %
字符之后插入 E
或 O
修饰符字符。每个转换说明符将被替换为输出中适当的字符,如下所述。
如果 时间规范
为空,则时间对象将被格式化,就像通过将它流式传输到类型为 std::basic_ostringstream<CharT>
的 os
对象一样,并使用格式化区域设置(std::locale::classic()
、传递的 std::locale
对象和 std::locale::global()
之一)注入 并在将 os.str()
复制到输出缓冲区时根据格式说明符进行额外填充和调整。
可以使用以下格式说明符
转换 说明符 |
说明 | |
---|---|---|
%%
|
写入文字 % 字符。 | |
%n
|
写入换行符。 | |
%t
|
写入水平制表符。 | |
星期几 | ||
%a
|
写入区域设置的简短星期几名称。 | |
%A
|
写入区域设置的完整星期几名称。 | |
%u %Ou
|
以十进制数 (1-7) 写入 ISO 星期几,其中星期一是 1 。修改后的命令 | |
%w %Ow
|
以十进制数 (0-6) 写入星期几,其中星期日是 0 。修改后的命令 |
识别以下说明符,但会导致抛出 std::format_error
转换 说明符 |
说明 | |
---|---|---|
年份 | ||
%C %EC
|
使用向下取整除法写入年份除以 100 的结果。如果结果是一个十进制数字,则在其前面加上 0。 修改后的命令 | |
%y %Oy %Ey
|
写入年份的后两位十进制数字。如果结果是一位数,则在其前面加上 0。 修改后的命令 修改后的命令 | |
%Y %EY
|
将年份写入十进制数字。如果结果小于四位数,则用 0 左填充至四位数。 修改后的命令 | |
月份 | ||
%b %h
|
写入该语言环境的缩写月份名称。 | |
%B
|
写入该语言环境的完整月份名称。 | |
%m %Om
|
将月份写入十进制数字(一月为01 )。如果结果是一位数,则在其前面加上 0。修改后的命令 | |
日期 | ||
%d %Od
|
将月份中的日期写入十进制数字。如果结果是一位十进制数字,则在其前面加上 0。 修改后的命令 | |
%e %Oe
|
将月份中的日期写入十进制数字。如果结果是一位十进制数字,则在其前面加上空格。 修改后的命令 | |
ISO 8601 基于周的年份 | ||
在 ISO 8601 中,一周从周一开始,并且一年的第一周必须满足以下要求
| ||
%g
|
写入 ISO 8601 基于周的年份的后两位十进制数字。如果结果是一位数,则在其前面加上 0。 | |
%G
|
将 ISO 8601 基于周的年份写入十进制数字。如果结果小于四位数,则用 0 左填充至四位数。 | |
%V %OV
|
将 ISO 8601 年份中的周数写入十进制数字。如果结果是一位数,则在其前面加上 0。 修改后的命令 | |
年份中的周/天 | ||
%j
|
将一年中的日期写入十进制数字(1 月 1 日为001 )。如果结果小于三位数,则用 0 左填充至三位数。 | |
%U %OU
|
将一年中的周数写入十进制数字。一年的第一个星期日是第 01 周的第一天。该年之前的天数在第 00 周。如果结果是一位数,则在其前面加上 0。 修改后的命令 | |
%W %OW
|
将一年中的周数写入十进制数字。一年的第一个星期一是第 01 周的第一天。该年之前的天数在第 00 周。如果结果是一位数,则在其前面加上 0。 修改后的命令 | |
日期 | ||
%D
|
相当于"%m/%d/%y" 。 | |
%F
|
相当于"%Y-%m-%d" 。 | |
%x %Ex
|
写入该语言环境的日期表示。 修改后的命令 | |
一天中的时间 | ||
%H %OH
|
将小时(24 小时制)写入十进制数字。如果结果是一位数,则在其前面加上 0。 修改后的命令 | |
%I %OI
|
将小时(12 小时制)写入十进制数字。如果结果是一位数,则在其前面加上 0。 修改后的命令 | |
%M %OM
|
将分钟写入十进制数字。如果结果是一位数,则在其前面加上 0。 修改后的命令 | |
%S %OS
|
将秒写入十进制数字。如果秒数小于 10,则在结果前面加上 0。 如果输入的精度不能用秒精确表示,则格式为带有固定格式的十进制浮点数,精度与输入的精度匹配(或者如果转换为浮点十进制秒不能在 18 位小数内完成,则精度为微秒精度)。小数点的字符将根据语言环境进行本地化。 修改后的命令 | |
%p
|
写入该语言环境等效于与 12 小时制相关的 AM/PM 指示。 | |
%R
|
相当于"%H:%M" 。 | |
%T
|
相当于"%H:%M:%S" 。 | |
%r
|
写入该语言环境的 12 小时制时间。 | |
%X %EX
|
写入该语言环境的时间表示。 修改后的命令 | |
持续时间计数 | ||
%Q
|
写入持续时间的刻度计数,即通过 count() 获得的值。 | |
%q
|
写入持续时间的单位后缀,如 operator<<() 中所指定。 | |
时区 | ||
%z %Ez %Oz
|
以 ISO 8601 格式写入相对于 UTC 的偏移量。例如-0430 表示比 UTC 晚 4 小时 30 分钟。如果偏移量为零,则使用+0000 。修改后的命令 | |
%Z
|
写入时区缩写。 | |
其他 | ||
%c %Ec
|
写入该语言环境的日期和时间表示。 修改后的命令 |
[edit] 示例
本节不完整 原因:没有示例 |
[edit] 缺陷报告
以下行为更改缺陷报告已追溯应用于之前发布的 C++ 标准。
DR | 应用于 | 发布的行为 | 正确行为 |
---|---|---|---|
P2372R3 | C++20 | formatter 使用全局语言环境或传递的语言环境 |
当L 缺失时使用默认 "C" 语言环境 |
[edit] 另请参见
(C++20) |
将参数的格式化表示存储在新的字符串中 (函数模板) |