std::time_put<CharT,OutputIt>:: put, std::time_put<CharT,OutputIt>:: do_put

std::tm オブジェクトが指すカレンダー日時を、 フォーマット文字列 [fmtbeg, fmtend) に従って文字列に変換します。フォーマット文字列は std:: strftime で使用されるものと同じですが、各フォーマット指定子は個別の do_put() 呼び出しによって処理され、このファセットを拡張することでカスタマイズ可能です。

パラメータ

フォーマット文字列

書式文字列は、0個以上の変換指定子と（ % 以外の）通常の文字で構成されます。すべての通常の文字（終端のnull文字を含む）は変更されずに出力文字列にコピーされます。各変換指定は % 文字で始まり、オプションで E または O 修飾子（ロケールでサポートされていない場合は無視される）が続き、その後に指定子の動作を決定する文字が続きます。以下の書式指定子が利用可能です：

`、`$`タグ内のテキストは翻訳せず保持\; -\; C++固有の用語（tm\_hour、tm\_minなど）は翻訳せず保持\; -\; 「equivalent\; to」を「～に相当」と専門的に翻訳$

戻り値

生成された最後の文字の次の位置を指すイテレータ。

注記

エラーハンドリングは提供されていません。

fill 文字は、実装定義の書式指定子およびパディングとフィリングのロジックを使用する do_put() のユーザー定義オーバーライドに対して提供されます。このような実装では通常、 str からの書式フラグを利用します。

例

#include <iostream>
#include <sstream>
#include <iomanip>
#include <ctime>
void try_time_put(const std::tm* t, const std::string& fmt)
{
    std::cout.imbue(std::locale());
    std::cout << "In the locale '" << std::cout.getloc().name() << "' : '";
    std::use_facet<std::time_put<char>>(std::cout.getloc()).put(
        {std::cout}, std::cout, ' ', t, &fmt[0], &fmt[0] + fmt.size());
    std::cout << "'\n";
}
int main()
{
    std::time_t t = std::time(NULL);
    std::tm tm = *std::localtime(&t);
    std::string fmt = "%c";
    std::cout << "Using the format string '" << fmt
              << "' to format the time: " << std::ctime(&t) << '\n';
    std::locale::global(std::locale("de_DE.utf8"));
    try_time_put(&tm, fmt);
    std::locale::global(std::locale("el_GR.utf8"));
    try_time_put(&tm, fmt);
    std::locale::global(std::locale("ja_JP.utf8"));
    try_time_put(&tm, fmt);
}

Using the format string '%c' to format the time: Mon Feb 11 22:58:50 2013
In the locale 'de_DE.utf8' : 'Mo 11 Feb 2013 23:02:38 EST'
In the locale 'el_GR.utf8' : 'Δευ 11 Φεβ 2013 11:02:38 μμ EST'
In the locale 'ja_JP.utf8' : '2013年02月11日 23時02分38秒'

不具合報告

以下の動作変更の欠陥報告書は、以前に公開されたC++規格に対して遡及的に適用されました。

関連項目