C++ 参考手册

位置：首页 > C++ 参考手册 >日期和时间工具 >std::chrono::duration > std::formatter<std::chrono::duration>

std::formatter<std::chrono::duration>

定义于头文件 <chrono>
template<class Rep, class Period, class CharT>
struct formatter<std::chrono::duration<Rep, Period>, CharT>;

std::formatter 的特化，定义 std::chrono::duration 的格式化规则。 duration 被转译为自午夜起经过的时间。

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

格式说明

格式说明拥有形式

填充与对齐(可选) 宽度(可选) 精度(可选) 时间说明(可选)

填充与对齐 、 宽度 及 精度 拥有同标准格式说明中的含义。 精度 仅对表示类型 Rep 为浮点类型的 std​::​chrono​::​duration 类型合法，否则抛出 std::format_error 。

时间说明 由一或更多个转换说明符与通常字符（除了 { 、 } 与 % ）构成。 时间说明 必须始于一个转换说明符。写入所有通常字符到输出而不修改。每个无修饰的转换说明符始于 % 字符后随一个确定说明符行为的字符。某些转换说明符拥有修饰形式，其中 E 或 O 修饰字符插入到 % 字符后。按描述于下的方式以适合的字符替换每个转换说明符。

若 时间说明 为空，则如同以流化时间对象到 std::stringstream os 并复制 os.str() 到输出缓冲，附带按照每个格式说明符的填充和调整一般，格式化时间对象。

下列格式说明符可用：

转换
说明符 		解释
%% 写字面的 % 字符。
%n 写换行符。
%t 写水平制表符。
日之时间
%H
%OH 		按十进制数字写时（ 24 小时时钟）。若结果为单个数位，则前附 0 。

修饰的命令 %OH 写本地环境的替用表示。

%I
%OI 		按十进制数字写时（ 12 小时时钟）。若结果为单个数位，则前附 0 。

修饰的命令 %OI 写本地环境的替用表示。

%M
%OM 		按十进制数字写分。若结果为单个数位，则前附 0 。

修饰的命令 %OM 写本地环境的替用表示。

%S
%OS 		按十进制数字写秒。若结果为单个数位，则前附 0 。

若输入的精度不能准确地以秒表示，则格式为 fixed 格式且精度匹配输入精度的十进制浮点数（或若不能在 18 位小数内转换到浮点数十进制秒，则为到微秒精度）。用作小数点的字符按照本地环境本地化。

修饰的命令 %OS 写本地环境的替用表示。

%p 写与 12 小时时钟相关的 AM/PM 设计的本地环境版本。
%R 等价于 "%H:%M" 。
%T 等价于 "%H:%M:%S" 。
%r 写本地环境的 12 小时时钟时间。
%X
%EX 		写本地环境的时间表示。

修饰的命令 %EX 写本地环境的替用时间表示。

下列说明符得到辨识，但会导致抛出 std::format_error ：

转换
说明符 		解释
年
%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 产生本地环境的替用日期表示。

杂项
%c
%Ec 		写本地环境的日期与时间表示。

修饰的命令 %Ec 写本地环境的替用日期与时间表示。

%z
%Ez
%Oz 		以 ISO 8601 格式写自 UTC 的偏移。例如 -0430 表示 UTC 后 4 小时 30 分。若偏移为 0 ，则使用 +0000 。

修饰的命令 %Ez 与 %Oz 在时与分间插入 : （例如 -04:30 ）。

%Z 写时区缩写。

示例

本节未完成
原因：暂无示例

参阅

(C++20)
 在新 string 中存储参数的格式化表示
(函数模板)