std::formatter<std::chrono::tai_time>

来自cppreference.com
< cpp‎ | chrono‎ | tai clock

 
C++
 
日期和时间工具
时间点
(C++11)
(C++20)
时长
(C++11)
时钟
(C++11)
(C++11)
(C++11)      
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
当天时刻
(C++20)(C++20)
(C++20)(C++20)
(C++20)

日历
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
时区
(C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)
(C++20)
chrono I/O
(C++20)
C 风格日期和时间
 
std::chrono::tai_clock
成员函数
时间点 I/O
formatter<std::chrono::tai_time>
 
在标头 <chrono> 定义
template<class Duration, class CharT>
struct formatter<std::chrono::tai_time<Duration>, CharT>;
 (C++20 起)

std::formatter 的特化，定义 std::chrono::tai_time 的格式化规则。

若使用 %Z ，则将它替换成加宽到 CharT 的 "TAI" 。若使用 %z 或其有修饰的变体，则将格式化 0min 的偏移。 格式化的日期和时间等价于对以 std::chrono::sys_time<Duration>(tp.time_since_epoch()) - std::chrono::days(4383) 初始化的 std::chrono::sys_time 所格式化者。

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

格式说明

格式说明拥有形式

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

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

用于格式化的本地环境确定如下：

  • 若格式说明中不存在 L 则为默认的 "C" 本地环境，
  • 否则，若有传递给格式化函数的 std::locale 则为其所代表的本地环境，
  • 否则（ L 存在但无传递给格式化函数的 std::locale ）为全局本地环境。

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

若 时间说明 为空，则如同以流化时间对象到 std::stringstream 类型对象 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 产生本地环境的替用日期表示。

当天时刻
%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 写本地环境的替用时间表示。


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

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

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

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

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

转换
说明符 		解释
时长计数
%Q 写时长的计次数，即经由 count() 获得的值。
%q 写 operator<<() 中指定的时长单位后缀。

示例

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

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
P2372R3 C++20 formatter 使用全局本地环境或传递的本地环境 在缺少 L 时使用默认 "C" 本地环境

参阅

(C++20)
 在新 string 中存储参数的格式化表示
(函数模板)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/chrono/tai_clock/formatter&oldid=75831”