std::formatter<std::chrono::utc_time>

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

 
C++
 
日期和时间工具
时间点
(C++11)
(C++20)
时长
(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)
chrono I/O
(C++20)
C 风格日期和时间
 
std::chrono::utc_clock
成员函数
时间点 I/O
formatter<std::chrono::utc_time>
闰秒插入信息
 
在标头 <chrono> 定义
template< class Duration, class CharT >
struct formatter<std::chrono::utc_time<Duration>, CharT>;
 (C++20 起)

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

若使用 %Z，则将它替换成加宽到 CharT 的 "UTC"。若使用 %z 或其有修饰的变体，则将格式化 0min 的偏移。 若实参表示闰秒插入段的时间，且格式化 second 域，则该域的整数部分为加宽到 CharT 的 "60"。

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

格式说明

格式说明拥有形式

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

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

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

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

如果（通常或宽）字符串字面量编码为 Unicode 编码形式且本地环境在一个实现定义的本地环境集合中，则如同将替换字符序列转换到该字面量编码一般，进行每个取决于本地环境的替换。

时间说明 由一或更多个转换说明符与（除了 {、} 与 % 外的）普通字符构成。时间说明 必须始于一个转换说明符。所有普通字符均不修改地写入到输出。每个无修饰的转换说明符始于 % 字符后随一个确定说明符行为的字符。某些转换说明符拥有修饰形式，其中将 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<<() 中指定的时长单位后缀。

示例

运行此代码
#include <chrono>
#include <format>
#include <iostream>
 
int main()
{
    std::chrono::time_point<std::chrono::utc_clock> epoch;
 
    std::cout << std::format("Unix 纪元时间为 {0:%F}T{0:%R%z}。", epoch)
              << '\n';
}

输出： 

Unix 纪元时间为 1970-01-01T00:00+0000。

缺陷报告

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

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

参阅

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