CppDS.com

C++ 98 11 14 17 20 手册

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

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

初等字符串转换
(C++17)
(C++17)
 
日期和时间工具
(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 风格日期和时间
 
 
定义于头文件 <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

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

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