std::formatter<std::chrono::local_time>, std::chrono::local_time_format

来自cppreference.com
< cpp‎ | chrono‎ | local t
 
 
工具库
通用工具
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)

初等字符串转换
(C++17)
(C++17)
栈踪
 
 
std::chrono::local_t
时间点 I/O
formatter<std::chrono::local_time>
 
定义于头文件 <chrono>
template<class Duration, class CharT>
struct formatter<std::chrono::local_time<Duration>, CharT>;
(1)
(2)
template<class Duration>

struct /*local-time-format-t*/ { // 仅用于阐释
    std::chrono::local_time<Duration> time; // 仅用于阐释
    const std::string* abbrev;              // 仅用于阐释
    const std::chrono::seconds* offset;     // 仅用于阐释

};
template<class Duration>

/*local-time-format-t*/<Duration>
    local_time_format(const std::chrono::local_time<Duration>& tp,
                      const std::string* abbrev = nullptr,

                      const std::chrono::seconds* offset_sec = nullptr);
template<class Duration, class CharT>
struct formatter</*local-time-format-t*/<Duration>, CharT>;

std::formatter 的特化,定义 std::chrono::local_time 的格式化规则。

1) 若使用 %Z%z%z 的有修饰变体,则抛出 std::format_error
2) local_time_format 函数返回保有本地时间、偏移及时区缩写的未指定类型。
格式化此未指定类型的对象 f 时,若使用 %Z ,则若 f.abbrev 非空则替换它为加宽到 CharT*f.abbrev ;否则抛出 std::format_error 。若使用 %z 或其有修饰变体,则若 f.offset_sec 非空则格式化 *f.offset_sec 的偏移;否则抛出 std::format_error

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

格式说明

格式说明拥有形式

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

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

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

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

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

时间说明 为空,则如同以流化时间对象到 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++20)
在新 string 中存储参数的格式化表示
(函数模板)