template< class CharT >
/*unspecified*/ get_time( std::tm* tmb, const CharT* fmt ); |
|
(C++11 起) |
| | |
用于表达式 in >> get_time(tmb, fmt) 时，按照格式字符串 fmt 及输入流 in 中当前感染的 locale 的 std::time_get 平面，分析字符输入为日期/时间值。存储结果值于 tmb 所指向的 std::tm 对象中。
参数
| tmb
|
-
|
指向 std::tm 对象的合法指针，结果将存储于其处
|
| fmt
|
-
|
指向指定转换格式的空终止 CharT 字符串的指针
格式字符串由零或更多转换说明符、空白符和通常字符（除了 % ）组成。期待每个通常字符以大小无关比较匹配输入流中的一个字符。每个空白符匹配输入字符串中的任意空白符。每个转换说明始于 % 字符，可选地后随 E 或 O 修饰符（若本地环境不支持则忽略），后随确定说明符转换行为的字符。格式说明符匹配 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) 表现为如同执行下列代码：
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);
注意
如 std::time_get::do_get 中所指定，此函数是否清零出现于 fmt 中的格式指定符所不直接选择的 *tmb 中的域，是未指定的：可移植程序应该在调用 std::get_time 前初始化 *tmb 的每个域。
示例
#include <iostream>
#include <sstream>
#include <locale>
#include <iomanip>
int main()
{
std::tm t = {};
std::istringstream ss("2011-Februar-18 23:12:34");
ss.imbue(std::locale("de_DE.utf-8"));
ss >> std::get_time(&t, "%Y-%b-%d %H:%M:%S");
if (ss.fail()) {
std::cout << "Parse failed\n";
} else {
std::cout << std::put_time(&t, "%c") << '\n';
}
}可能的输出：
参阅
|
|
从输入字符序列中解析时间/日期值到 std::tm 中
(类模板) |
|
|
按照指定格式格式化并输出日期/时间值
(函数模板) |