std:: put_time

当在表达式 out << put_time ( tmb, fmt ) 中使用时，根据 格式字符串 fmt ，将给定日历时间 tmb 中的日期和时间信息转换为字符字符串，转换过程如同调用 std::strftime 、 std::wcsftime 或类似函数（具体取决于 CharT ），并依据当前输出流 out 所植入的区域设置的 std::time_put facet 进行。

参数

格式字符串

格式字符串由零个或多个转换说明符和普通字符（除 % 外）组成。所有普通字符（包括终止空字符）都会未经修改地复制到输出字符串中。每个转换规范以 % 字符开头，可选地后跟 E 或 O 修饰符（若区域设置不支持则忽略），最后是决定说明符行为的字符。可用的格式说明符如下：

返回值

一个未指定类型的对象，使得

• 若 out 是类型为 std:: basic_ostream < CharT, Traits > 的对象，则表达式 out << put_time ( tmb, fmt )
  • 具有类型 std:: basic_ostream < CharT, Traits > &
  • 具有值 out
  • 行为如同调用了 f ( out, tmb, fmt )

其中函数 f 的定义为：

template<class CharT, class Traits>
void f(std::basic_ios<CharT, Traits>& str, const std::tm* tmb, const CharT* fmt)
{
    using Iter = std::ostreambuf_iterator<CharT, Traits>;
    using TimePut = std::time_put<CharT, Iter>;
    const TimePut& tp = std::use_facet<TimePut>(str.getloc());
    const Iter end = tp.put(Iter(str.rdbuf()), str, str.fill(), tmb,
        fmt, fmt + Traits::length(fmt));
    if (end.failed())
        str.setstate(std::ios_base::badbit);
}

示例

#include <ctime>
#include <iomanip>
#include <iostream>
int main()
{
    std::time_t t = std::time(nullptr);
    std::tm tm = *std::localtime(&t);
    std::cout.imbue(std::locale("ru_RU.utf8"));
    std::cout << "ru_RU: " << std::put_time(&tm, "%c %Z") << '\n';
    std::cout.imbue(std::locale("ja_JP.utf8"));
    std::cout << "ja_JP: " << std::put_time(&tm, "%c %Z") << '\n';
}

ru_RU: Ср. 28 дек. 2011 10:21:16 EST
ja_JP: 2011年12月28日 10時21分16秒 EST

另请参阅