命名空间
变体
操作

std::time_put<CharT,OutputIt>::put, std::time_put<CharT,OutputIt>::do_put

来自 cppreference.cn
 
C++
 
文本处理库
 
本地化库
 
std::time_put
成员函数
time_put::puttime_put::do_put
 
定义于头文件 <locale>
public:

iter_type put( iter_type out, std::ios_base& str,
               char_type fill, const std::tm* t,

               const CharT* fmtbeg, const CharT* fmtend ) const;
 (1)
public:

iter_type put( iter_type out, std::ios_base& str,
               char_type fill, const std::tm* t,

               char format, char modifier = 0 ) const;
 (2)
protected:

virtual iter_type do_put( iter_type out, std::ios_base& str,
                          char_type fill, const std::tm* t,

                          char format, char modifier ) const;
 (3)

根据 格式字符串 [fmtbeg, fmtend)，将存储在 std::tm 对象（由 t 指向）中的日历日期和时间转换为字符串。格式字符串与 std::strftime 使用的相同，但每个格式说明符都通过对 do_put() 的单独调用进行处理，这可以通过扩展此 facet 来定制。

1) 遍历字符序列 [fmtbeg, fmtend)，检查字符。每个不属于格式序列的字符都会立即写入输出迭代器 out。为了识别格式序列，此函数将 [fmtbeg, fmtend) 中的下一个字符 c 窄化，就像通过 std::ctype<char_type>(str.getloc()).narrow(c, 0) 一样，如果它等于 '%'，则将接下来的一到两个字符与 std::strftime 识别的格式序列列表以及此区域设置支持的任何其他实现定义的格式进行比较。对于每个有效的格式序列，都会调用 do_put(out, str, fill, t, format, modifier)，其中 format 是格式序列字符，modifier 是可选的格式序列修饰符（'E' 或 'O'）。如果修饰符不存在，则使用 '\0' 的值。
2) 调用最派生类的 do_put 成员函数。
3) 将存储在 std::tm 对象（由 t 指向）中的日历日期和时间转换为字符串，根据由连接 '%'、modifier（如果不是 '\0'）的值和 format 的值组成的格式转换序列。格式的解释方式与函数 std::strftime 相同，但描述为与区域设置相关的格式由当前区域设置定义，并且可能支持额外的格式说明符（为这些实现定义的格式说明符提供了 fill 参数）。字符串写入输出迭代器 out。

目录

[编辑] 参数

out - 写入转换结果的输出迭代器
str - 此函数在需要时用于获取区域设置 facet 的流对象，例如 std::ctype 来窄化字符
t - 指向 std::tm 对象的指针，从中获取日期/时间值
fmtbeg - 指向指定 转换格式 的 char_type 字符序列的第一个字符的指针
fmtend - 指向指定 转换格式 的 char_type 字符序列的最后一个字符之后的一个位置的指针
fill - 填充字符（通常为空格）
format - 命名 转换说明符 的字符
modifier - 可能出现在 % 和 转换说明符 之间的可选修饰符

[编辑] 格式字符串

格式字符串由零个或多个转换说明符和普通字符（除了 %）组成。所有普通字符，包括终止空字符，都将不加修改地复制到输出字符串中。每个转换规范以 % 字符开头，可选地后跟 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中，周以星期一开始，一年的第一周必须满足以下要求

  • 包含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年（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

[编辑] 返回值

指向所生成字符串最后一个字符之后一个位置的迭代器。

[编辑] 注意

不提供错误处理。

提供 fill 字符是为了那些实现定义的格式说明符，以及使用填充逻辑的用户定义的 do_put() 重载。此类实现通常利用 str 中的格式化标志。

[编辑] 示例

运行此代码
#include <iostream>
#include <sstream>
#include <iomanip>
#include <ctime>
 
void try_time_put(const std::tm* t, const std::string& fmt)
{
    std::cout.imbue(std::locale());
    std::cout << "In the locale '" << std::cout.getloc().name() << "' : '";
 
    std::use_facet<std::time_put<char>>(std::cout.getloc()).put(
        {std::cout}, std::cout, ' ', t, &fmt[0], &fmt[0] + fmt.size());
 
    std::cout << "'\n";
}
 
int main()
{
    std::time_t t = std::time(NULL);
    std::tm tm = *std::localtime(&t);
 
    std::string fmt = "%c";
    std::cout << "Using the format string '" << fmt
              << "' to format the time: " << std::ctime(&t) << '\n';
 
    std::locale::global(std::locale("de_DE.utf8"));
    try_time_put(&tm, fmt);
 
    std::locale::global(std::locale("el_GR.utf8"));
    try_time_put(&tm, fmt);
 
    std::locale::global(std::locale("ja_JP.utf8"));
    try_time_put(&tm, fmt);
}

可能的输出

Using the format string '%c' to format the time: Mon Feb 11 22:58:50 2013
 
In the locale 'de_DE.utf8' : 'Mo 11 Feb 2013 23:02:38 EST'
In the locale 'el_GR.utf8' : 'Δευ 11 Φεβ 2013 11:02:38 μμ EST'
In the locale 'ja_JP.utf8' : '2013年02月11日 23時02分38秒'

[编辑] 缺陷报告

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

缺陷报告 应用于 发布时的行为 正确的行为
LWG 164 C++98 参数 fill 的目的不明确 已明确

[编辑] 另请参阅

(C++11)
 根据指定格式格式化并输出日期/时间值
(函数模板) [编辑]
[virtual] (C++11)
 根据指定格式从输入流中提取日期/时间组件
(std::time_get<CharT,InputIt> 的虚保护成员函数) [编辑]
取自“https://cppreference.cn/mwiki/index.php?title=cpp/locale/time_put/put&oldid=143571”