std::get_time

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (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 > /*unspecified*/ get_time( std::tm* tmb, const CharT* fmt );		(自 C++11 起)

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

参数

tmb	-	指向 std::tm 对象的有效指针，结果将存储在该对象中
fmt	-	指向指定转换格式的空终止 CharT 字符串的指针 格式字符串由零个或多个转换说明符、空白字符和普通字符（除了 %）组成。每个普通字符应与输入流中的一个字符匹配（不区分大小写比较）。每个空白字符与输入字符串中的任意空白匹配。每个转换规范以 % 字符开始，可选地后跟 E 或 O 修饰符（如果区域设置不支持则忽略），后跟确定说明符行为的字符。格式说明符与 POSIX 函数 strptime() 匹配 转换 说明符 解释 写入字段 % 匹配字面量 %。完整的转换规范必须是 %% （无） t 匹配任何空白 （无） n 匹配任何空白 （无） 年份 Y 解析完整年份为 4 位十进制数，允许但不要求前导零 tm_year EY 以替代表示形式解析年份，例如 ja_JP 区域设置中的 平成23年（平成 23 年），它将 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 中的 平成（平成时代） 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年（平成 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 以观察输出。 12.1 之前的 libstdc++ 未正确实现 %b 说明符：bug #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 对象 (函数模板)