std::put_time

来自cppreference.com
< cpp‎ | io‎ | manip

 
 
输入/输出库
I / O操纵
C-风格的I / O
缓冲区
原文:
Buffers
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
basic_streambuf
basic_filebuf
basic_stringbuf
strstreambuf(过时)
原文:
Streams
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
抽象
原文:
Abstractions
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
ios_base
basic_ios
basic_istream
basic_ostream
basic_iostream
文件I / O
原文:
File I/O
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
basic_ifstream
basic_ofstream
basic_fstream
字符串I / O
原文:
String I/O
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
basic_istringstream
basic_ostringstream
basic_stringstream
阵列的I / O
原文:
Array I/O
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
istrstream(过时)
ostrstream(过时)
strstream(过时)
类型
原文:
Types
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
streamoff
streamsize
fpos
Error类的接口
原文:
Error category interface
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
iostream_category(C++11)
io_errc(C++11)
 
输入/输出操纵符
浮点格式
原文:
Floating-point formatting
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
整型格式
原文:
Integer formatting
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
布尔格式
原文:
Boolean formatting
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
boolalpha
noboolalpha
场的宽度和填充控制
原文:
Field width and fill control
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
其他格式
原文:
Other formatting
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
空白处理
原文:
Whitespace processing
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
输出冲洗
原文:
Output flushing
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
状态标志位操作
原文:
Status flags manipulation
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
时间和金钱I / O
原文:
Time and money I/O
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
get_money(C++11)
get_time(C++11)
put_money(C++11)
put_time(C++11)
 
定义于头文件 <iomanip>
template< class charT >
/*unspecified*/ put_time( const std::tm* tmb, const charT* fmt);
(C++11起)
使用时,在表达式中out << put_time(tmb, fmt),作为转换的日期和时间信息,从一个给定的日历时间tmb一个字符串根据格式字符串fmt,如果通过调用std::strftimestd::wcsftime,或模拟(取决于CharT),根据std::time_put小面区域目前在输出流中充满out
原文:
When used in an expression out << put_time(tmb, fmt), converts the date and time information from a given calendar time tmb to a character string according to format string fmt, as if by calling std::strftime, std::wcsftime, or analog (depending on CharT), according to the std::time_put facet of the locale currently imbued in the output stream out.
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
这个函数的作用格式化输出功能.
原文:
This function behaves as a formatted output function.
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里

目录

[编辑] 参数

tmb -
localtime的()或gmtime的()获得日历时间结构的指针
原文:
pointer to the calendar time structure as obtained from localtime() or gmtime()
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里
fmt -
指针指向一个空结束的图表字符串,该字符串指定的格式转换。

格式字符串由零或更多个限定符和通常字符(除%)构成。所有通常字符,包括空终止字符,都会被不加修改地复制到输出字符串。每个转换限定符都以%字符为首,可选地跟随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 写本地化的时间展示(本地环境依赖)。 全部
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
原文:
pointer to a null-terminated CharT string specifying the format of conversion.

格式字符串由零或更多个限定符和通常字符(除%)构成。所有通常字符,包括空终止字符,都会被不加修改地复制到输出字符串。每个转换限定符都以%字符为首,可选地跟随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 写本地化的时间展示(本地环境依赖)。 全部
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
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里

[编辑] 返回值

返回out是,如果一个输出流的类型std::basic_ostream<CharT, Traits>的名称,然后表达out << put_time(tmb, fmt)的行为,如果下面的代码被执行对象的类型不明确
原文:
Returns an object of unspecified type such that if out is the name of an output stream of type std::basic_ostream<CharT, Traits>, then the expression out << put_time(tmb, fmt) behaves as if the following code was executed:
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里

typedef std::ostreambuf_iterator<CharT, Traits> Iter;
typedef std::time_put<CharT, Iter> TimePut;
const TimePut& tp = std::use_facet<TimePut>(out.getloc());
const Iter end = tp.put(Iter(out.rdbuf()), out, out.fill(), tmb, fmt, fmt + Traits::length(fmt));
if (end.failed())
    out.setstate(std::ios_base::badbit);


[编辑] 示例

#include <iostream>
#include <iomanip>
#include <ctime>
int main()
{
    std::time_t t = std::time(NULL);
    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

[编辑] 另请参阅

格式内容的struct std::tm输出字符序列
原文:
formats contents of struct std::tm for output as character sequence
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里

(类模板) [edit]
tm对象转换成自定义的文字表述
原文:
converts a tm object to custom textual representation
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里

(函数) [edit]
自定义的宽字符串的文字表述转换为tm对象
原文:
converts a tm object to custom wide string textual representation
这段文字是通过 Google Translate 自动翻译生成的。
您可以帮助我们检查、纠正翻译中的错误。详情请点击这里

(函数) [edit]