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 > /*未指定*/ 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	-	指向指定转换格式的空终止 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)：
  • 具有 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 中所指定，未指明此函数是否将未由 fmt 中出现的转换指定符所直接设置的 *tmb 中的字段清零：可移植程序在调用 std::get_time 前应该初始化 *tmb 的每个字段。

示例

注意：选择 clang 或 12.1 及以上版本的 gcc 以观察输出。12.1 版本以前的 libstdc++ 未正确实现 %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 << "解析失败\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 对象 (函数模板)