std::formatter<std::chrono::file_time>
定义于头文件 <chrono>
|
||
template<class Duration, class CharT> struct formatter<std::chrono::file_time<Duration>, CharT>; |
||
std::formatter 的特化,定义 std::chrono::file_time 的格式化规则。
若使用 %Z
,则将它替换成加宽到 CharT
的 "UTC" 。若使用 %z
或其有修饰的变体,则将格式化 0min
的偏移。
格式化的日期和时间等价于对 std::chrono::clock_cast<std::chrono::system_clock>(tp) 或 std::chrono::clock_cast<std::chrono::utc_clock>(tp) 所格式化者,其中 tp
表示格式化参数。
通常不直接访问,但通过格式化函数使用 std::formatter 特化。
格式说明
格式说明拥有形式
填充与对齐(可选) 宽度(可选) 精度(可选) 时间说明(可选) | |||||||||
填充与对齐 、 宽度 及 精度 拥有同标准格式说明中的含义。 精度 仅对表示类型 Rep
为浮点类型的 std::chrono::duration 类型合法,否则抛出 std::format_error 。
时间说明 由一或更多个转换说明符与通常字符(除了 {
、 }
与 %
)构成。 时间说明 必须始于一个转换说明符。写入所有通常字符到输出而不修改。每个无修饰的转换说明符始于 %
字符后随一个确定说明符行为的字符。某些转换说明符拥有修饰形式,其中 E
或 O
修饰字符插入到 %
字符后。按描述于下的方式以适合的字符替换每个转换说明符。
若 时间说明 为空,则如同以流化时间对象到 std::stringstream os 并复制 os.str() 到输出缓冲,附带按照每个格式说明符的填充和调整一般,格式化时间对象。
下列格式说明符可用:
转换 说明符 |
解释 | |
---|---|---|
%%
|
写字面的 % 字符。
| |
%n
|
写换行符。 | |
%t
|
写水平制表符。 | |
年 | ||
%C %EC
|
写年除以 100 向下取整除的结果。若结果为单个十进制位,则前附 0 。
修饰的命令 | |
%y %Oy %Ey
|
写年的末二位十进制数。若结果为单个数位,则前附 0 。
修饰的命令 修饰的命令 | |
%Y %EY
|
按十进制数写年。若结果少于四位,则左填充 0 到四位。
修饰的命令 | |
月 | ||
%b %h
|
写本地环境的缩写月名。 | |
%B
|
写本地环境的完整月名。 | |
%m %Om
|
按十进制数写月份(一月为 01 )。若结果为单个数位,则前附 0 。
修饰的命令 | |
日 | ||
%d %Od
|
按十进制数写月之日。若结果为单个十进制位,则前附 0 。
修饰的命令 | |
%e %Oe
|
按十进制数写月之日。若结果为单个十进制位,则前附空格。
修饰的命令 | |
星期之日 | ||
%a
|
写本地环境的缩写星期名。 | |
%A
|
写本地环境的完整星期名。 | |
%u %Ou
|
按十进制数写 ISO 星期之日( 1-7 ),其中星期一为 1 。
修饰的命令 | |
%w %Ow
|
写星期之日为十进制数( 0-6 ),其中星期日为 0 。
修饰的命令 | |
基于 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
|
按十进制数字写秒。若结果为单个数位,则前附 0 。
若输入的精度不能准确地以秒表示,则格式为 fixed 格式且精度匹配输入精度的十进制浮点数(或若不能在 18 位小数内转换到浮点数十进制秒,则为到微秒精度)。用作小数点的字符按照本地环境本地化。 修饰的命令 | |
%p
|
写与 12 小时时钟相关的 AM/PM 设计的本地环境版本。 | |
%R
|
等价于 "%H:%M" 。
| |
%T
|
等价于 "%H:%M:%S" 。
| |
%r
|
写本地环境的 12 小时时钟时间。 | |
%X %EX
|
写本地环境的时间表示。
修饰的命令 | |
杂项 | ||
%c %Ec
|
写本地环境的日期与时间表示。
修饰的命令 | |
%z %Ez %Oz
|
以 ISO 8601 格式写自 UTC 的偏移。例如 -0430 表示 UTC 后 4 小时 30 分。若偏移为 0 ,则使用 +0000 。
修饰的命令 | |
%Z
|
写时区缩写。 |
示例
本节未完成 原因:暂无示例 |
参阅
(C++20) |
在新 string 中存储参数的格式化表示 (函数模板) |