std::put_time

用于表达式 out << put_time(tmb, fmt) 时，按照格式字符串 fmt，按照输出流 out 中当前浸染的本地环境的 std::time_put 刻面，将来自给定的日历时间 tmb 的日期和时间信息转换到字符串，如同通过调用 std::strftime、std::wcsftime 或类似物（取决于CharT）。

参数

格式字符串

格式字符串由零或更多个说明符和（除 % 外的）普通字符构成。所有普通字符，包括空终止字符，都会被复制到输出字符串而不加修改。每个转换说明符都始于 % 字符，可选地跟随 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

参阅