std::get_time

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

输入/输出库

I/O 操纵符

打印函数 (C++23)

C 样式 I/O

缓冲区

basic_streambuf

basic_filebuf

basic_stringbuf

basic_spanbuf (C++23)

strstreambuf (C++98/26*)

basic_syncbuf (C++20)

流

抽象

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

文件 I/O

basic_ifstream

basic_ofstream

basic_fstream

字符串 I/O

basic_istringstream

basic_ostringstream

basic_stringstream

数组 I/O

basic_ispanstream (C++23)

basic_ospanstream (C++23)

basic_spanstream (C++23)

istrstream (C++98/26*)

ostrstream (C++98/26*)

strstream (C++98/26*)

同步输出

basic_osyncstream (C++20)

类型

streamoff

streamsize

fpos

错误类别接口

iostream_category (C++11)

io_errc (C++11)

 

输入/输出操纵符

浮点格式化
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
整数格式化
setbase showbasenoshowbase	dechexoct
布尔格式化
boolalphanoboolalpha
字段宽度和填充控制
setfill setw	internalleftright
其他格式化
showposnoshowpos	uppercasenouppercase
空白处理
ws ends	skipwsnoskipws
输出刷新
flush endl flush_emit (C++20)	unitbufnounitbuf emit_on_flushnoemit_on_flush (C++20)(C++20)
状态标志操作
resetiosflags	setiosflags
时间和货币 I/O
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)
带引号的操纵符
quoted (C++14)

 

定义在头文件 <iomanip> 中
template< class CharT > /*未指定*/ get_time( std::tm* tmb, const CharT* fmt );		(自 C++11 起)

当在表达式 in >> get_time(tmb, fmt) 中使用时，根据格式字符串 fmt 解析字符输入为日期/时间值，并根据当前注入到输入流 in 中的区域设置的 std::time_get 面。结果值存储在由 tmb 指向的 std::tm 对象中。

参数

tmb	-	指向 std::tm 对象的有效指针，结果将存储在此对象中
fmt	-	指向指定转换格式的以 null 结尾的 CharT 字符串的指针 格式字符串由零个或多个转换说明符、空格字符和普通字符（除了 %）组成。每个普通字符都应在不区分大小写的情况下与输入流中的一个字符匹配。每个空格字符都与输入字符串中的任意空格匹配。每个转换说明符都以 % 字符开头，后面可以可选地跟 E 或 O 修饰符（如果区域设置不支持则忽略），最后跟确定说明符行为的字符。格式说明符与 POSIX 函数 strptime() 匹配 转换 说明符 解释 写入字段 % 匹配文字 %。完整的转换说明符必须为 %% (无) t 匹配任何空格 (无) n 匹配任何空格 (无) 年 Y 解析完整的 **年** 作为 4 位十进制数字，允许前导零，但不要求 tm_year EY 解析 **年** 在替代表示中，例如 平成23年 (Heisei 年 23)，在 ja_JP 区域设置中将 2011 写入 tm_year tm_year y 解析 **年** 的最后 2 位作为十进制数字。范围 [69,99] 导致值 1969 到 1999，范围 [00,68] 导致 2000-2068 tm_year Oy 使用替代数字系统解析 **年** 的最后 2 位，例如 十一 在 ja_JP 区域设置中解析为 11 tm_year Ey 解析 **年** 作为区域设置的替代日历周期 %EC 的偏移量 tm_year C 解析 **年** 的前 2 位作为十进制数字（范围 [00,99]） tm_year EC 解析区域设置的替代表示中的基年（周期）的名称，例如 在 ja_JP 中为 平成 (Heisei 时代) 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 从 12 小时制中解析 **时**，使用替代数字系统，例如 六 在 ja_JP 区域设置中读取为 06 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年 (Heisei 年 23) 而不是 2011年 (年 2011) 全部 x 解析区域设置的标准日期表示 全部 Ex 解析区域设置的备用日期表示形式，例如，在 ja_JP 区域设置中，预期的是 平成23年（平成23年）而不是 2011年（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 解析区域设置的等效于 上午或下午 tm_hour 注意：tm_isdst 未写入，需要显式设置才能与 mktime 等函数一起使用

返回值

一个未指定类型的对象，使得

• 如果 in 是类型 std::basic_istream<CharT, Traits> 的对象，则表达式 in >> get_time(tmb, fmt)
  • 具有类型 std::basic_istream<CharT, Traits>&
  • 具有值 in
  • 行为如同它调用了 f(in, tmb, fmt)

其中函数 f 定义为

template<class CharT, class Traits>
void f(std::basic_ios<CharT, Traits>& str, std::tm* tmb, const CharT* fmt)
{
    using Iter = std::istreambuf_iterator<CharT, Traits>;
    using TimeGet = time_get<CharT, Iter>;
 
    std::ios_base::iostate err = std::ios_base::goodbit;
    const TimeGet& tg = std::use_facet<TimeGet>(str.getloc());
 
    tg.get(Iter(str.rdbuf()), Iter(), str, err, tmb,
        fmt, fmt + Traits::length(fmt));
 
    if (err != std::ios_base::goodbit)
        str.setstate(err);
}

注释

如 std::time_get::do_get（此函数调用它）中所述，此函数是否将 *tmb 中未由 fmt 中出现的转换说明符直接设置的字段清零是不确定的：可移植程序应在调用 std::get_time 之前将 *tmb 的每个字段初始化为零。

示例

注意：选择 clang 或 gcc >= 12.1 才能观察到输出。libstdc++ 12.1 之前的版本未正确实现 %b 说明符：错误 #78714。

运行此代码

#include <iomanip>
#include <iostream>
#include <locale>
#include <sstream>
 
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';
}

可能的输出

Sun Feb 18 23:12:34 2011

另请参见

time_get	将时间/日期值从输入字符序列解析到 std::tm (类模板)
put_time (C++11)	根据指定的格式格式化并输出日期/时间值 (函数模板)
parse (C++20)	从流中解析 chrono 对象 (函数模板)