std::time_get

来自cppreference.com
< cpp‎ | locale
 
 
本地化库
本地环境与平面
本地环境
平面类别基类
ctype(字符类别)平面
numeric(数值)平面
collate(对照比较)平面
time(时间)平面
time_get
monetary(货币)平面
messages(消息)平面
字符分类与转换
字符分类
转换
编码转换平面
(C++11)    
C 本地环境
 
 
在标头 <locale> 定义
template<

    class CharT,
    class InputIt = std::istreambuf_iterator<CharT>

> class time_get;

类模板 std::time_get 封装日期和时间分析规则。输入/输出操纵符 std::get_time 用输入/输出流的本地环境的 std::time_get 平面将文本输入转换成 std::tm 对象。

cpp/locale/time basecpp/locale/locale/facetstd-time get-inheritance.svg

继承图

如果标准库不保证提供 std::time_get 的某个特化(见下文),那么它的成员函数(构造函数和析构函数除外)不保证会遵守指定的行为。

特化

标准库保证提供以下特化(所有本地环境对象都需要实现这些特化):

在标头 <locale> 定义
std::time_get<char> 分析日期和时间的窄字符串表示
std::time_get<wchar_t> 分析日期和时间的宽字符串表示

另外,标准库也保证提供满足以下类型要求的所有特化:

成员类型

成员类型 定义
char_type CharT
iter_type InputIt

成员函数

构造新的 time_get 平面
(公开成员函数)
析构 time_get 平面
(受保护成员函数)
调用 do_date_order
(公开成员函数)
调用 do_get_time
(公开成员函数)
调用 do_get_date
(公开成员函数)
调用 do_get_weekday
(公开成员函数)
调用 do_get_monthname
(公开成员函数)
调用 do_get_year
(公开成员函数)
(C++11)
调用 do_get
(公开成员函数)

成员对象

static std::locale::id id
本地环境的 id
(公开成员对象)

受保护成员函数

获得偏好的日、月、年顺序
(虚受保护成员函数)
从输入流提取时、分、秒
(虚受保护成员函数)
从输入流提取月、日以及年
(虚受保护成员函数)
从输入流提取星期的日名
(虚受保护成员函数)
从输入流提取月名
(虚受保护成员函数)
从输入流提取年份
(虚受保护成员函数)
[虚] (C++11)
从输入流按照指定格式提取日期/时间组分
(虚受保护成员函数)

继承自 std::time_base

类型 定义
dateorder 日期顺序枚举类型,定义值 no_orderdmymdyymdydm

示例

注意:选择 clang 观察输出。libstdc++ 当前未实现 %b 说明符:漏洞 78714

#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';
}

可能的输出:

Sun Feb 18 23:12:34 2011

参阅

格式化 std::tm 内容为字符序列以输出
(类模板)
(C++11)
剖析指定格式的日期/时间值
(函数模板)