std:: strftime

与えられたカレンダー時刻 tp から日時情報を、 フォーマット文字列 format に従ってナル終端マルチバイト文字列 str に変換します。最大 count バイトが書き込まれます。

パラメータ

フォーマット文字列

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

戻り値

str が指す文字配列に書き込まれたバイト数（終端の ' \0 ' を除く）。文字列全体を格納する前に count に達した場合、 ​ 0 ​ が返され、内容は不定となる。

例

#include <ctime>
#include <iostream>
#include <iterator>
#include <locale>
void utcExample()
{
    // RFC 3339形式のUTC時刻の例
    std::time_t time = std::time({});
    char timeString[std::size("yyyy-mm-ddThh:mm:ssZ")];
    std::strftime(std::data(timeString), std::size(timeString),
                  "%FT%TZ", std::gmtime(&time));
    std::cout << timeString << '\n';
}
int main()
{
    std::time_t t = std::time(nullptr);
    char mbstr[100];
    if (std::strftime(mbstr, sizeof(mbstr), "%A %c", std::localtime(&t)))
        std::cout << mbstr << '\n';
    std::locale::global(std::locale("ja_JP.utf8"));
    if (std::strftime(mbstr, sizeof(mbstr), "%A %c", std::localtime(&t)))
        std::cout << mbstr << '\n';
    utcExample();
}

Tuesday Tue Sep  7 19:40:35 2021
火曜日 2021年09月07日 19時40分35秒
2021-09-07T19:40:35Z

関連項目