std::get_time

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

定义于头文件 <iomanip>
template< class CharT >
/*unspecified*/ get_time( std::tm* tmb, const CharT* fmt);
(C++11 起)
使用时,表达in >> get_time(tmb, fmt),解析作为一个日期/时间值的格式字符串的字符输入fmt根据目前的语言环境充满在输出流中std::time_getout方面。所得到的值被存储在一个std::tm对象所指向tmb.
原文:
When used in an expression in >> get_time(tmb, fmt), parses the character input as a date/time value according to format string fmt according to the std::time_get facet of the locale currently imbued in the output stream out. The resultant value is stored in a std::tm object pointed to by tmb.
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

目录

[编辑] 参数

tmb -
有效的指针的std :: TM的结果将被存储的对象
原文:
valid pointer to the std::tm object where the result will be stored
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。
fmt -
指向一个空结束的图表指定转换格式的字符串的指针

格式字符串由零或更多转换指定符、空白符和通常字符(除了 % )组成。期待每个通常字符以大小无关比较匹配输入流中的一个字符。每个空白符匹配输入字符串中的任意空白符。每个转换指定始于 % 字符,可选地后随 EO 修饰符(若本地环境不支持则忽略),后随确定指定符转换行为的字符。格式指定符匹配 POSIX 函数 strptime()

转换指定符 解释 写入域
% 匹配字面 % 。完整转换指定必须是 %% (无)
t 匹配任何空白符。 (无)
n 匹配任何空白符。 (无)
Y 分析完整为四位十进制数,容许但不要求前导零 tm_year
EY 以替用表示分析,例如 平成23年 在 ja_JP 本地环境中写 2011 到 tm_year tm_year
y 分析的后二位为十进制数。范围 [69,99] 生成 1969 至 1999 的值,范围 [00,68] 生成 2000-2068 tm_year
Oy 以替用数值系统分析的后二位数字,例如 十一 在 ja_JP 本地环境中被分析为 11 tm_year
Ey 分析为从本地环境的替用日历周期 %EC 的偏移 tm_year
C 分析的首 2 位数字为十进制数(范围 [00,99] tm_year
EC 分析本地环境的替用表示中,年基底(周期)的名称,例如 ja_JP 中的 平成 tm_year
b 分析月份名,完整或缩写,例如 Oct tm_mon
h b 的同义词 tm_mon
B b 的同义词 tm_mon
m 分析为十进制数(范围 [01,12] ),容许但不要求前导零 tm_mon
Om 用替代数值系统分析,例如 ja_JP 本地环境中 十二 分析为 12 tm_mon
星期
U 分析年之星期为十进制数(星期日是星期的首日)(范围 [00,53] ),容许但不要求前导零 tm_year, tm_wday, tm_yday
OU 用替用数值系统,如以 %U 一般分析年之星期,例如 ja_JP 本地环境中 五十二 分析为 52 tm_year, tm_wday, tm_yday
W 分析年之星期为十进制数(星期一是星期的首日)(范围 [00,53] ),容许但不要求前导零 tm_year, tm_wday, tm_yday
OW 用替用数值系统,如以 %W 一般分析年之星期,例如 ja_JP 本地环境中 五十二 分析为 52 tm_year, tm_wday, tm_yday
年/月之日
j 分析年之日为十进制数(范围 [001,366] ),容许但不要求前导零 tm_yday
d 分析月之日为十进制数(范围 [01,31] ),容许但不要求前导零 tm_mday
Od 用替用数值系统分析月之日,例如 ja_JP 本地环境中 二十七 分析为 27 ,容许但不要求前导零 tm_mday
e d 的同义词 tm_mday
Oe Od 的同义词 tm_mday
星期之日
a 分析星期的日名,完整或缩写版,例如 Fri tm_wday
A a 的同义词 tm_wday
w 分析星期之日为十进制数,其中星期日为 0 (范围 [0-6] tm_wday
Ow 用替用数值系统分析星期之日为十进制数,其中星期日为 0 ,例如 ja_JP 本地环境中 二 分析为 2 tm_wday
时、分、秒
H 分析为十进制数,以 24 小时时钟(范围 [00,23] ) ,容许但不要求前导零 tm_hour
OH 用替用数值系统分析来自 24 小时时钟的,例如 ja_JP 本地环境中 十八 分析为 18 tm_hour
I 分析为十进制数,以 12 小时时钟(范围 [01,12] ) ,容许但不要求前导零 tm_hour
OI 用替用数值系统分析,例如 ja_JP 本地环境中 六 分析为 6 tm_hour
M 分析为十进制数(范围 [00,59] ),容许但不要求前导零 tm_min
OM 用替用数值系统分析,例如 ja_JP 本地环境中 二十五 分析为 25 tm_min
S 分析为十进制数(范围 [00,60] ),容许但不要求前导零 tm_sec
OS 用替用数值系统分析,例如 ja_JP 本地环境中 二十四 分析为 24 tm_sec
其他
c 分析本地环境的标准日期和时间字符串格式,例如 Sun Oct 17 04:41:13 2010 (本地环境依赖) 所有
Ec 分析本地环境的替用时期和时间字符串格式,例如期待在 ja_JP 本地环境中以 平成23年 取代 2011年 所有
x 分析本地环境的标准日期表示 所有
Ex 分析本地环境的替用日期表示,例如期待在 ja_JP 本地环境中以 平成23年 取代 2011年 所有
X 分析本地环境的标准时间表示 所有
EX 分析本地环境的替用时间表示 所有
D 等价于 "%m / %d / %y " tm_mon, tm_mday, tm_year
r 等价于本地环境的标准 12 小时时钟时间( POSIX 中为 "%I : %M : %S %p" tm_hour, tm_min, tm_sec
R 等价于 "%H : %M" tm_hour, tm_min
T 等价于 "%H : %M : %S" tm_hour, tm_min, tm_sec
p 分析 a.m. 或 p.m. 的本地环境等价版本 tm_hour

注意:不写入 tm_isdst ,需要用如 mktime 的函数显式设置它。

原文:
pointer to a null-terminated CharT string specifying the conversion format

格式字符串由零或更多转换指定符、空白符和通常字符(除了 % )组成。期待每个通常字符以大小无关比较匹配输入流中的一个字符。每个空白符匹配输入字符串中的任意空白符。每个转换指定始于 % 字符,可选地后随 EO 修饰符(若本地环境不支持则忽略),后随确定指定符转换行为的字符。格式指定符匹配 POSIX 函数 strptime()

转换指定符 解释 写入域
% 匹配字面 % 。完整转换指定必须是 %% (无)
t 匹配任何空白符。 (无)
n 匹配任何空白符。 (无)
Y 分析完整为四位十进制数,容许但不要求前导零 tm_year
EY 以替用表示分析,例如 平成23年 在 ja_JP 本地环境中写 2011 到 tm_year tm_year
y 分析的后二位为十进制数。范围 [69,99] 生成 1969 至 1999 的值,范围 [00,68] 生成 2000-2068 tm_year
Oy 以替用数值系统分析的后二位数字,例如 十一 在 ja_JP 本地环境中被分析为 11 tm_year
Ey 分析为从本地环境的替用日历周期 %EC 的偏移 tm_year
C 分析的首 2 位数字为十进制数(范围 [00,99] tm_year
EC 分析本地环境的替用表示中,年基底(周期)的名称,例如 ja_JP 中的 平成 tm_year
b 分析月份名,完整或缩写,例如 Oct tm_mon
h b 的同义词 tm_mon
B b 的同义词 tm_mon
m 分析为十进制数(范围 [01,12] ),容许但不要求前导零 tm_mon
Om 用替代数值系统分析,例如 ja_JP 本地环境中 十二 分析为 12 tm_mon
星期
U 分析年之星期为十进制数(星期日是星期的首日)(范围 [00,53] ),容许但不要求前导零 tm_year, tm_wday, tm_yday
OU 用替用数值系统,如以 %U 一般分析年之星期,例如 ja_JP 本地环境中 五十二 分析为 52 tm_year, tm_wday, tm_yday
W 分析年之星期为十进制数(星期一是星期的首日)(范围 [00,53] ),容许但不要求前导零 tm_year, tm_wday, tm_yday
OW 用替用数值系统,如以 %W 一般分析年之星期,例如 ja_JP 本地环境中 五十二 分析为 52 tm_year, tm_wday, tm_yday
年/月之日
j 分析年之日为十进制数(范围 [001,366] ),容许但不要求前导零 tm_yday
d 分析月之日为十进制数(范围 [01,31] ),容许但不要求前导零 tm_mday
Od 用替用数值系统分析月之日,例如 ja_JP 本地环境中 二十七 分析为 27 ,容许但不要求前导零 tm_mday
e d 的同义词 tm_mday
Oe Od 的同义词 tm_mday
星期之日
a 分析星期的日名,完整或缩写版,例如 Fri tm_wday
A a 的同义词 tm_wday
w 分析星期之日为十进制数,其中星期日为 0 (范围 [0-6] tm_wday
Ow 用替用数值系统分析星期之日为十进制数,其中星期日为 0 ,例如 ja_JP 本地环境中 二 分析为 2 tm_wday
时、分、秒
H 分析为十进制数,以 24 小时时钟(范围 [00,23] ) ,容许但不要求前导零 tm_hour
OH 用替用数值系统分析来自 24 小时时钟的,例如 ja_JP 本地环境中 十八 分析为 18 tm_hour
I 分析为十进制数,以 12 小时时钟(范围 [01,12] ) ,容许但不要求前导零 tm_hour
OI 用替用数值系统分析,例如 ja_JP 本地环境中 六 分析为 6 tm_hour
M 分析为十进制数(范围 [00,59] ),容许但不要求前导零 tm_min
OM 用替用数值系统分析,例如 ja_JP 本地环境中 二十五 分析为 25 tm_min
S 分析为十进制数(范围 [00,60] ),容许但不要求前导零 tm_sec
OS 用替用数值系统分析,例如 ja_JP 本地环境中 二十四 分析为 24 tm_sec
其他
c 分析本地环境的标准日期和时间字符串格式,例如 Sun Oct 17 04:41:13 2010 (本地环境依赖) 所有
Ec 分析本地环境的替用时期和时间字符串格式,例如期待在 ja_JP 本地环境中以 平成23年 取代 2011年 所有
x 分析本地环境的标准日期表示 所有
Ex 分析本地环境的替用日期表示,例如期待在 ja_JP 本地环境中以 平成23年 取代 2011年 所有
X 分析本地环境的标准时间表示 所有
EX 分析本地环境的替用时间表示 所有
D 等价于 "%m / %d / %y " tm_mon, tm_mday, tm_year
r 等价于本地环境的标准 12 小时时钟时间( POSIX 中为 "%I : %M : %S %p" tm_hour, tm_min, tm_sec
R 等价于 "%H : %M" tm_hour, tm_min
T 等价于 "%H : %M : %S" tm_hour, tm_min, tm_sec
p 分析 a.m. 或 p.m. 的本地环境等价版本 tm_hour

注意:不写入 tm_isdst ,需要用如 mktime 的函数显式设置它。

文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

[编辑] 返回值

返回in是,如果一个输入流的类型std::basic_istream<CharT, Traits>的名称,然后表达in >> get_time(tmb, fmt)的行为,如果下面的代码被执行对象的类型不明确
原文:
Returns an object of unspecified type such that if in is the name of an input stream of type std::basic_istream<CharT, Traits>, then the expression in >> get_time(tmb, fmt) behaves as if the following code was executed:
文本通过谷歌翻译机器翻译。
你可以帮忙校正和验证翻译。点击此处查看指示。

typedef std::istreambuf_iterator<CharT, Traits> Iter;
typedef std::time_get<CharT, Iter> TimeGet;
std::ios_base::iostate err = std::ios_base::goodbit;
const TimeGet& tg = std::use_facet<TimeGet>(in.getloc());
tg.get(Iter(in.rdbuf()), Iter(), in, err, tmb, fmt, fmt + traits::length(fmt));
if (err != std::ios_base::goodbit)
    in.setstate(err):


[编辑] 示例

#include <iostream>
#include <sstream>
#include <locale>
#include <iomanip>
#include <ctime>
 
int main()
{
    std::tm t;
    std::istringstream ss("2011-Februar-18 23:12:34");
    ss.imbue(std::locale("de_DE"));
    ss >> std::get_time(&t, "%Y-%b-%d %H:%M:%S");
    std::cout << std::put_time(&t, "%c") << '\n';
}

输出:

Sun Feb 18 23:12:34 2011

[编辑] 另请参阅

从输入字符序列剖析时间/日期值为 struct std::tm
(类模板) [编辑]
(C++11)
按照指定格式格式化并输出日期/时间值
(函数模板) [编辑]