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

来自cppreference.com
< cpp‎ | locale‎ | time put
 
 
本地化库
本地环境与平面
本地环境
平面类别基类
ctype(字符类别)平面
numeric(数值)平面
collate(对照比较)平面
time(时间)平面
monetary(货币)平面
messages(消息)平面
字符分类与转换
字符分类
转换
编码转换平面
(C++11)    
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) 将存储于 t 指向的 std::tm 对象中的日历日期和时间转换到字符串。格式字符串与 std::strftime 使用的相同,但每个格式指定符会通过对 do_put() 的单独调用处理,这可以通过扩展此平面定制。

1) 逐步通过字符序列 [fmtbeg, fmtend) 检验字符。每个不是格式序列的字符都会立即被写入输出迭代器 out。为鉴别格式序列,此函数如同用 std::ctype<char_type>(str.getloc()).narrow(c,0) 窄化 [fmtbeg, fmtend) 中的下个字符 c,而在它等于 '%' 时会将下一个或下两个字符与 std::strftime 所辨识的格式序列列表,加此本地环境所支持的任何额外实现定义格式比较。对每个合法格式序列进行调用 do_put(out, str, fill, t, format, modifier),其中 format 是格式序列字符,而 modifier 是可选的格式序列修饰符('E''O')。修饰符不存在时会使用值 '\0'
2) 调用最终派生类的 do_put 成员函数。
3) 按照由连接 '%'modifier 的值(如果不是 '\0'),和 format 的值组成的格式转换序列,将存储于 t 指向的 std::tm 对象中的日历日期和时间转换到字符串。格式转译方式同函数 std::strftime ,除了描述为本地环境依赖的格式由此本地环境定义,而且可以支持另外的格式指定符(为这些要使用的实现定义格式指定符提供 fill 参数)。将字符串写入输出迭代器 out

参数

out - 输出迭代器,其中写入转换结果
str - 此函数在需要时用以获得本地环境刻面的流对象,例如用 std::ctype 窄化字符
t - 指向 std::tm 对象的指针,从该对象获得日期/时间值
fmtbeg - 指向指定转换格式的 char_type 字符序列首字符的指针

格式字符串由零或更多个说明符和通常字符(除 % )构成。所有通常字符,包括空终止字符,都会被复制到输出字符串而不加修改。每个转换说明符都始于 % 字符,可选地跟随 EO 修饰符(若本地环境不支持则忽略),后随决定修饰符行为的字符。下列修饰符格式可用:

转换
说明符
解释 使用的域
% 写字面的 % 。完整转换说明必须是 %%
n
(C++11)
写换行符
t
(C++11)
写水平制表符
Y 以 4 位十进制数写 tm_year
EY
(C++11)
以替用方式写。例如在 ja_JP 本地环境中,以“平成23年”取代“2011年”。 tm_year
y 的末 2 位十进制数(范围[00,99])。 tm_year
Oy
(C++11)
以替用数字系统写的末 2 位数字。例如在 ja_JP 本地环境中以“十一”取代“11”。 tm_year
Ey
(C++11)
写作从本地环境的替用时期 %EC 的偏移(本地环境依赖)。 tm_year
C
(C++11)
的首 2 位十进制数(范围 [00,99] )。 tm_year
EC
(C++11)
以本地环境的替用表示写年份基底(时期),例如 ja_JP 中的“平成”。 tm_year
G
(C++11)
基于 ISO 8601 的年,即是包含指定星期的年份。

IS0 8601 中星期以星期一开始,而且一年的首星期必须满足下列要求:

  • 包含 1 月 4 日
  • 包含一年的首个星期四
tm_year, tm_wday, tm_yday
g
(C++11)
基于 ISO 8601 的年,即是包含指定星期年份,的后 2 位数(范围 [00,99] )。

IS0 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 的年的星期(范围[00,53])。

IS0 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)
以十进制数写月的第几日(范围[01,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 本地环境中“六”取代“6”。 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年”取代“2011年”。 全部
x 写本地化的日期表示(本地环境依赖)。 全部
Ex
(C++11)
替用日期表示。例如 ja_JP 本地环境中“平成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 格式(例如 -0430 )写距 UTC 的偏移,或者倘若时区信息不可用则不写字符。 tm_isdst
Z 写依赖本地环境的时区名或缩写,或者若时区信息不可用则不写字符。 tm_isdst


fmtend - 指向指定转换格式的 char_type 字符序列的末字符后一位置的指针
fill - 填充字符(通常为空格)
format - 指名转换指定符的字符
modifier - 可以在 % 和转换指定符间出现的可选修饰符

返回值

指向最后产生字符后一位置的迭代器。

注解

不提供错误处理。

为实现定义的格式指定符,和使用填充和填满逻辑的用户定义的 do_put() 覆写提供 fill 字符。这种实现典型地利用来自 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 << "在本地环境 '" << 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 << "使用格式字符串 '" << fmt
              << "' 格式化时间:" << 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);
}

可能的输出:

使用格式字符串 '%c' 格式化时间:Mon Feb 11 22:58:50 2013
 
在本地环境 'de_DE.utf8' 中:'Mo 11 Feb 2013 23:02:38 EST'
在本地环境 'el_GR.utf8' 中:'Δευ 11 Φεβ 2013 11:02:38 μμ EST'
在本地环境 'ja_JP.utf8' 中:'2013年02月11日 23時02分38秒'

缺陷报告

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

缺陷报告 应用于 出版时的行为 正确行为
LWG 164 C++98 提供形参 fill 的目的不明确 使之明确

参阅

(C++11)
按照指定格式格式化并输出日期/时间值
(函数模板)
[虚] (C++11)
从输入流按照指定格式提取日期/时间组分
(std::time_get<CharT,InputIt> 的虚受保护成员函数)