命名空间
变体
操作

std::time_get

来自 cppreference.com
< cpp‎ | locale
 
 
 
 
定义在头文件 <locale>
template<

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

> class time_get;

类模板 std::time_get 封装了日期和时间解析规则。I/O 操作符 std::get_time 使用 I/O 流的区域设置的 std::time_get 面将文本输入转换为 std::tm 对象。

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

继承图

如果标准库不能保证提供 std::time_get 特化(见下文),则其成员函数(构造函数和析构函数除外)的行为不能保证与规定一致。

内容

[edit] 特化

标准库保证提供以下特化(它们是 任何区域设置对象都必须实现的

定义在头文件 <locale>
std::time_get<char> 解析日期和时间的窄字符串表示形式
std::time_get<wchar_t> 解析日期和时间的宽字符串表示形式

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

  • CharTcharwchar_t 之一,并且
  • InputIt 必须满足 LegacyInputIterator 的要求。

[edit] 成员类型

成员类型 定义
char_type CharT
iter_type InputIt

[edit] 成员函数

构造一个新的 time_get 面。
(公共成员函数)
析构一个 time_get 面。
(受保护的成员函数)
调用 do_date_order
(公共成员函数) [edit]
调用 do_get_time
(公共成员函数) [edit]
调用 do_get_date
(公共成员函数) [edit]
调用 do_get_weekday
(公共成员函数) [edit]
调用 do_get_monthname
(公共成员函数) [edit]
调用 do_get_year
(公共成员函数) [edit]
(C++11)
调用 do_get
(公共成员函数) [edit]

[edit] 成员对象

static std::locale::id id
区域设置的 id
(公共成员对象)

[edit] 受保护的成员函数

获取天、月和年的首选顺序。
(虚拟受保护的成员函数) [edit]
[virtual]
从输入流中提取小时、分钟和秒。
(虚拟受保护的成员函数) [edit]
[virtual]
从输入流中提取月、日和年。
(虚拟受保护的成员函数) [edit]
从输入流中提取星期的名称。
(虚拟受保护的成员函数) [edit]
从输入流中提取月份名称。
(虚拟受保护的成员函数) [edit]
[virtual]
从输入流中提取年份。
(虚拟受保护的成员函数) [edit]
[virtual] (C++11)
根据指定的格式从输入流中提取日期/时间组件。
(虚拟受保护的成员函数) [edit]

std::time_base 继承而来

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

[编辑] 示例

注意:选择 clang 才能观察输出。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

[编辑] 另请参阅

格式化 std::tm 的内容,以便将其作为字符序列输出
(类模板) [编辑]
(C++11)
解析指定格式的日期/时间值
(函数模板) [编辑]