命名空间
变体
操作

std::time_put

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

    class CharT,
    class OutputIt = std::ostreambuf_iterator<CharT>

> class time_put;

类模板 std::time_put 封装了日期和时间格式规则。I/O 操作符 std::put_time 使用 I/O 流的区域设置的 std::time_put 方面来生成 std::tm 对象的文本表示形式。

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

继承关系图

如果标准库不保证提供 std::time_put 特化 (见下文),则其 put()do_put() 的行为不保证与指定的行为一致。

内容

[编辑] 特化

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

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

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

  • CharTcharwchar_t 中的一个,并且
  • OutputIt 必须满足 LegacyOutputIterator 的要求。

[编辑] 成员类型

成员类型 定义
char_type CharT
iter_type OutputIt

[编辑] 成员函数

构造一个新的 time_put 方面
(公有成员函数) [编辑]
析构一个 time_put 方面
(受保护成员函数) [编辑]
调用 do_put
(公有成员函数) [编辑]

[编辑] 成员对象

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

[编辑] 受保护成员函数

[虚函数]
格式化日期/时间并写入输出流
(虚函数受保护成员函数) [编辑]

[编辑] 示例

#include <codecvt>
#include <ctime>
#include <iomanip>
#include <iostream>
 
int main()
{
    std::time_t t = std::time(nullptr);
    std::wbuffer_convert<std::codecvt_utf8<wchar_t>> conv(std::cout.rdbuf());
    std::wostream out(&conv);
    out.imbue(std::locale("ja_JP.utf8"));
 
    // this I/O manipulator std::put_time uses std::time_put<wchar_t>
    out << std::put_time(std::localtime(&t), L"%A %c") << '\n';
}

输出

水曜日 2011年11月09日 12時32分05秒

[编辑] 另请参阅

表示命名区域设置的系统提供的 std::time_put
(类模板) [编辑]
将输入字符序列中的时间/日期值解析为 std::tm
(类模板) [编辑]
(C++11)
根据指定的格式格式化并输出日期/时间值
(函数模板) [编辑]