wcsftime

将给定日历时间 time 中的日期和时间信息，按照 格式字符串 format 转换为以空字符结尾的宽字符字符串 str 。最多写入 count 个字节。

参数

格式字符串

格式字符串由零个或多个转换说明符和普通字符（除 % 外）组成。所有普通字符（包括终止空字符）会不经修改地复制到输出字符串中。每个转换说明以 % 字符开始，可选地后跟 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, // = 年份 2012
        .tm_mon = 9,    // = 第10个月
        .tm_mday = 9,   // = 第9天
        .tm_hour = 8,   // = 8小时
        .tm_min = 10,   // = 10分钟
        .tm_sec = 20    // = 20秒
    };
    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秒

参考文献

参见