命名空间
变体
操作

std::put_time

来自 cppreference.com
< cpp‎ | io‎ | manip
 
C++
 
输入/输出库
 
输入/输出操纵符
浮点格式化
整数格式化
布尔格式化
字段宽度和填充控制
其他格式化
空白处理
输出刷新
(C++20)  

状态标志操作
时间和货币 I/O
(C++11)
(C++11)
(C++11)
put_time
(C++11)
引用操纵符
(C++14)
 
在头文件 <iomanip> 中定义
template< class CharT >
/*未指定*/ put_time( const std::tm* tmb, const CharT* fmt );
 (自 C++11 起)

当在表达式 out << put_time(tmb, fmt) 中使用时，将给定日历时间 tmb 的日期和时间信息转换为字符字符串，转换为 格式字符串 fmt，如同通过调用 std::strftime，std::wcsftime 或类似函数（取决于 CharT）一样，根据当前注入到输出流 out 的区域设置的 std::time_put 面。

内容

[编辑] 参数

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年 (年 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 中，周从星期一开始，并且一年中的第一周必须满足以下要求

  • 包含 1 月 4 日
  • 包含一年中的第一个星期四
 tm_year, tm_wday, tm_yday
g
(C++11) 		写入ISO 8601 基于周的年份的后两位数字，即包含指定周的年份（范围 [00,99]）。

在 ISO 8601 中，周从星期一开始，并且一年中的第一周必须满足以下要求

  • 包含 1 月 4 日
  • 包含一年中的第一个星期四
 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 中，周从星期一开始，并且一年中的第一周必须满足以下要求

  • 包含 1 月 4 日
  • 包含一年中的第一个星期四
 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年（平成23年）而不是 2011年（2011年） 全部
x 编写本地化的日期表示（取决于本地化） 全部
Ex
(C++11) 		编写备用日期表示，例如在 ja_JP 本地化中使用 平成23年（平成23年）而不是 2011年（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 编写本地化的上午或下午（取决于本地化） tm_hour
z
(C++11) 		编写相对于 UTC 的偏移量，使用 ISO 8601 格式（例如-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 对象转换为自定义宽字符串文本表示
(函数) [编辑]
取自 "https://cppreference.cn/mwiki/index.php?title=cpp/io/manip/put_time&oldid=159179"