std:: put_time

式 out << put_time ( tmb, fmt ) で使用されると、指定されたカレンダー時刻 tmb から日付と時刻の情報を、 フォーマット文字列 fmt に従って文字列に変換します。これは、 std::strftime 、 std::wcsftime 、または類似の関数（ CharT に依存）を呼び出したかのように動作し、出力ストリーム out に現在設定されているロケールの std::time_put ファセットに従って処理されます。

パラメータ

フォーマット文字列

書式文字列は、0個以上の変換指定子と（ % 以外の）通常の文字で構成されます。すべての通常の文字（終端のnull文字を含む）は変更されずに出力文字列にコピーされます。各変換指定は % 文字で始まり、オプションで 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

関連項目