wcsftime

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

パラメータ

フォーマット文字列

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

戻り値

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

例

#include <locale.h>
#include <stdio.h>
#include <time.h>
#include <wchar.h>
int main(void)
{
    wchar_t buff[40];
    struct tm my_time =
    {
        .tm_year = 112, // = year 2012
        .tm_mon = 9,    // = 10th month
        .tm_mday = 9,   // = 9th day
        .tm_hour = 8,   // = 8 hours
        .tm_min = 10,   // = 10 minutes
        .tm_sec = 20    // = 20 secs
    };
    if (wcsftime(buff, sizeof buff, L"%A %c", &my_time))
        printf("%ls\n", buff);
    else
        puts("wcsftime failed");
    setlocale(LC_ALL, "ja_JP.utf8");
    if (wcsftime(buff, sizeof buff, L"%A %c", &my_time))
        printf("%ls\n", buff);
    else
        puts("wcsftime failed");
}

Sunday Sun Oct  9 08:10:20 2012
日曜日 2012年10月09日 08時10分20秒

参考文献

関連項目