std::time_put

来自cppreference.com
 
C++
 
文本处理库
 
本地化库
 
std::time_put
 
在标头 <locale> 定义 
template< 
    class CharT, 
    class OutputIt = std::ostreambuf_iterator<CharT> 
> class time_put;

类模板 std::time_put 封装日期和时间格式化规则。输入/输出操纵符 std::put_time 用输入/输出流的本地环境的 std::time_put 刻面生成 std::tm 对象的文本表示。

cpp/locale/time basecpp/locale/locale/facet

继承图

如果标准库不保证提供 std::time_put 的某个特化（见下文），那么它的成员函数 put() 和 do_put() 不保证会遵守指定的行为。

特化

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

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

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

嵌套类型

类型 定义
char_type CharT
iter_type OutputIt

数据成员

成员 描述
std::locale::id id [静态] 刻面标识

成员函数

 构造新的 time_put 刻面
(公开成员函数)
析构 time_put 刻面
(受保护成员函数)
调用 do_put
(公开成员函数)

受保护成员函数

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

示例

运行此代码
#include <codecvt>
#include <ctime>
#include <iomanip>
#include <iostream>

int main()
{
    std::time_t t = std::time(NULL);
    std::wbuffer_convert<std::codecvt_utf8<wchar_t>> conv(std::cout.rdbuf());
    std::wostream out(&conv);
    out.imbue(std::locale("ja_JP.utf8"));
    
    // 此输入/输出操纵符 std::put_time 使用 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)
 按照指定格式格式化并输出日期/时间值
(函数模板)