std::put_time
来自 cppreference.cn
定义于头文件 <iomanip> |
||
template< class CharT > /*unspecified*/ put_time( const std::tm* tmb, const CharT* fmt ); |
(C++11 起) | |
当在表达式 out << put_time(tmb, fmt) 中使用时,根据输出流 out 中当前嵌入的 std::time_put 面(facet),通过调用 std::strftime、std::wcsftime 或其类似函数(取决于 CharT
),将给定日历时间 tmb 中的日期和时间信息按照格式字符串 fmt 转换为字符字符串。
目录 |
[编辑] 参数
tmb | - | 指向从 std::localtime 或 std::gmtime 获取的日历时间结构体 |
fmt | - | 指向一个指定转换格式的空终止 CharT 字符串 |
[编辑] 格式字符串
格式字符串由零个或多个转换说明符和普通字符(除了 %
)组成。所有普通字符,包括终止空字符,都将不加修改地复制到输出字符串。每个转换说明符都以 %
字符开头,可选地后跟 E
或 O
修饰符(如果区域设置不支持则忽略),再后跟确定说明符行为的字符。可用的格式说明符如下:
转换 说明符 |
解释 | 使用的字段 |
---|---|---|
%
|
写入字面量 % 。完整的转换说明符必须是 %% 。 |
|
n (C++11) |
写入换行符 | |
t (C++11) |
写入水平制表符 | |
年 | ||
Y
|
将年份写入为十进制数字,例如 2017 | tm_year
|
EY (C++11) |
以替代表示形式写入年份,例如在 ja_JP 区域设置中是 平成23年(Heisei 23 年)而不是 2011年 | tm_year
|
y
|
将年份的后两位数字写入为十进制数字(范围 [00,99] ) |
tm_year
|
Oy (C++11) |
使用替代数字系统写入年份的后两位数字,例如在 ja_JP 区域设置中是 十一 而不是 11 | tm_year
|
Ey (C++11) |
将年份写入为区域设置替代日历周期 %EC 的偏移量(取决于区域设置) |
tm_year
|
C (C++11) |
将年份的前两位数字写入为十进制数字(范围 [00,99] ) |
tm_year
|
EC (C++11) |
以区域设置的替代表示形式写入基准年份(周期)的名称,例如在 ja_JP 中是 平成(Heisei 时代) | tm_year
|
G (C++11) |
写入 ISO 8601 基于周的年份,即包含指定周的年份。 在ISO 8601中,周以星期一开始,一年的第一周必须满足以下要求
|
tm_year , tm_wday , tm_yday |
g (C++11) |
写入 ISO 8601 基于周的年份的后两位数字,即包含指定周的年份(范围 [00,99] )。在ISO 8601中,周以星期一开始,一年的第一周必须满足以下要求
|
tm_year , tm_wday , tm_yday |
月 | ||
b
|
写入月份缩写名称,例如 Oct (取决于区域设置) |
tm_mon
|
h (C++11) |
b 的同义词 |
tm_mon
|
B
|
写入月份全称名称,例如 October (取决于区域设置) |
tm_mon
|
m
|
将月份写入为十进制数字(范围 [01,12] ) |
tm_mon
|
Om (C++11) |
使用替代数字系统写入月份,例如在 ja_JP 区域设置中是 十二 而不是 12 | tm_mon
|
周 | ||
U
|
将年份的周数写入为十进制数字(星期日是一周的第一天)(范围 [00,53] ) |
tm_year , tm_wday , tm_yday |
OU (C++11) |
使用替代数字系统写入年份的周数,如 %U 所定义,例如在 ja_JP 区域设置中是 五十二 而不是 52 |
tm_year , tm_wday , tm_yday |
W
|
将年份的周数写入为十进制数字(星期一是一周的第一天)(范围 [00,53] ) |
tm_year , tm_wday , tm_yday |
OW (C++11) |
使用替代数字系统写入年份的周数,如 %W 所定义,例如在 ja_JP 区域设置中是 五十二 而不是 52 |
tm_year , tm_wday , tm_yday |
V (C++11) |
写入 ISO 8601 年份的周数(范围 [01,53] )。在ISO 8601中,周以星期一开始,一年的第一周必须满足以下要求
|
tm_year , tm_wday , tm_yday |
OV (C++11) |
使用替代数字系统写入年份的周数,如 %V 所定义,例如在 ja_JP 区域设置中是 五十二 而不是 52 |
tm_year , tm_wday , tm_yday |
年/月中的日 | ||
j
|
将年份中的天数写入为十进制数字(范围 [001,366] ) |
tm_yday
|
d
|
将月份中的天数写入为十进制数字(范围 [01,31] ) |
tm_mday
|
Od (C++11) |
使用替代数字系统写入基于零的月份中的天数,例如在 ja_JP 区域设置中是 二十七 而不是 27 单个字符前面有一个空格。 |
tm_mday
|
e (C++11) |
将月份中的天数写入为十进制数字(范围 [1,31] )。单个数字前面有一个空格。 |
tm_mday
|
Oe (C++11) |
使用替代数字系统写入基于一的月份中的天数,例如在 ja_JP 区域设置中是 二十七 而不是 27 单个字符前面有一个空格。 |
tm_mday
|
星期几 | ||
a
|
写入星期几缩写名称,例如 Fri (取决于区域设置) |
tm_wday
|
A
|
写入星期几全称名称,例如 Friday (取决于区域设置) |
tm_wday
|
w
|
将星期几写入为十进制数字,其中星期日是 0 (范围 [0-6] ) |
tm_wday
|
Ow (C++11) |
使用替代数字系统写入星期几,其中星期日是 0 ,例如在 ja_JP 区域设置中是 二 而不是 2 |
tm_wday
|
u (C++11) |
将星期几写入为十进制数字,其中星期一是 1 (ISO 8601 格式)(范围 [1-7] ) |
tm_wday
|
Ou (C++11) |
使用替代数字系统写入星期几,其中星期一是 1 ,例如在 ja_JP 区域设置中是 二 而不是 2 |
tm_wday
|
时、分、秒 | ||
H
|
将小时写入为十进制数字,24 小时制(范围 [00-23] ) |
tm_hour
|
OH (C++11) |
使用替代数字系统写入 24 小时制小时,例如在 ja_JP 区域设置中是 十八 而不是 18 | tm_hour
|
I
|
将小时写入为十进制数字,12 小时制(范围 [01,12] ) |
tm_hour
|
OI (C++11) |
使用替代数字系统写入 12 小时制小时,例如在 ja_JP 区域设置中是 六 而不是 06 | tm_hour
|
M
|
将分钟写入为十进制数字(范围 [00,59] ) |
tm_min
|
OM (C++11) |
使用替代数字系统写入分钟,例如在 ja_JP 区域设置中是 二十五 而不是 25 | tm_min
|
S
|
将秒写入为十进制数字(范围 [00,60] ) |
tm_sec
|
OS (C++11) |
使用替代数字系统写入秒,例如在 ja_JP 区域设置中是 二十四 而不是 24 | tm_sec
|
其他 | ||
c
|
写入标准日期和时间字符串,例如 Sun Oct 17 04:41:13 2010 (取决于区域设置) |
所有 |
Ec (C++11) |
写入替代日期和时间字符串,例如在 ja_JP 区域设置中使用 平成23年(Heisei 23 年)而不是 2011年 | 所有 |
x
|
写入本地化日期表示(取决于区域设置) | 所有 |
Ex (C++11) |
写入替代日期表示,例如在 ja_JP 区域设置中使用 平成23年(Heisei 23 年)而不是 2011年 | 所有 |
X
|
写入本地化时间表示,例如 18:40:20 或 6:40:20 PM(取决于区域设置) | 所有 |
EX (C++11) |
写入替代时间表示(取决于区域设置) | 所有 |
D (C++11) |
等价于 "%m/%d/%y" | tm_mon , tm_mday , tm_year |
F (C++11) |
等价于 "%Y-%m-%d"(ISO 8601 日期格式) | tm_mon , tm_mday , tm_year |
r (C++11) |
写入本地化 12 小时制时间(取决于区域设置) | tm_hour , tm_min , tm_sec |
R (C++11) |
等价于 "%H:%M" | tm_hour , tm_min |
T (C++11) |
等价于 "%H:%M:%S"(ISO 8601 时间格式) | tm_hour , tm_min , tm_sec |
p
|
写入本地化 a.m. 或 p.m.(取决于区域设置) | tm_hour
|
z (C++11) |
以 ISO 8601 格式写入 UTC 偏移量(例如 -0430 ),如果时区信息不可用则不写入任何字符 |
tm_isdst
|
Z
|
写入取决于区域设置的时区名称或缩写,如果时区信息不可用则不写入任何字符 | tm_isdst
|
[编辑] 返回值
一个未指定类型的对象,使得
- 如果 out 是 std::basic_ostream<CharT, Traits> 类型,表达式 out << put_time(tmb, fmt)
- 具有类型 std::basic_ostream<CharT, Traits>&
- 值为 out
- 其行为如同调用了 f(out, tmb, fmt)
其中函数 f 定义为
template<class CharT, class Traits> void f(std::basic_ios<CharT, Traits>& str, const std::tm* tmb, const CharT* fmt) { using Iter = std::ostreambuf_iterator<CharT, Traits>; using TimePut = std::time_put<CharT, Iter>; const TimePut& tp = std::use_facet<TimePut>(str.getloc()); const Iter end = tp.put(Iter(str.rdbuf()), str, str.fill(), tmb, fmt, fmt + Traits::length(fmt)); if (end.failed()) str.setstate(std::ios_base::badbit); }
[编辑] 示例
运行此代码
#include <ctime> #include <iomanip> #include <iostream> int main() { std::time_t t = std::time(nullptr); std::tm tm = *std::localtime(&t); std::cout.imbue(std::locale("ru_RU.utf8")); std::cout << "ru_RU: " << std::put_time(&tm, "%c %Z") << '\n'; std::cout.imbue(std::locale("ja_JP.utf8")); std::cout << "ja_JP: " << std::put_time(&tm, "%c %Z") << '\n'; }
可能的输出
ru_RU: Ср. 28 дек. 2011 10:21:16 EST ja_JP: 2011年12月28日 10時21分16秒 EST
[编辑] 参阅
将 std::tm 的内容格式化为字符序列输出 (类模板) | |
(C++11) |
解析指定格式的日期/时间值 (函数模板) |
将 std::tm 对象转换为自定义文本表示 (函数) | |
将 std::tm 对象转换为自定义宽字符串文本表示 (函数) |