命名空间
变体
操作

wcsftime

来自 cppreference.cn
< c‎ | 时间
 
C
 
日期和时间工具
函数
时间操作
(C11)
(C23)
格式转换
(C23 中已废弃)(C11)
(C23 中已废弃)(C11)
wcsftime
(C95)
(C23)(C11)
(C23)(C11)
常量
类型
(C11)
 
在头文件 <wchar.h> 中定义
size_t wcsftime( wchar_t* str, size_t count, const wchar_t* format, const struct tm* time );
 (自 C95 起)

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

目录

[编辑] 参数

str - 指向用于输出的 wchar_t 数组的第一个元素的指针
count - 要写入的最大宽字符数
format - 指向以空字符结尾的宽字符串的指针，指定转换格式

[编辑] 格式字符串

格式字符串由零个或多个转换说明符和普通字符（除了 %）组成。所有普通字符，包括终止空字符，都被不加修改地复制到输出字符串中。每个转换规范以 % 字符开始，可选地后跟 E 或 O 修饰符（如果区域设置不支持则忽略），然后是确定说明符行为的字符。以下格式说明符可用：

转换
说明符		 解释 使用的字段
% 写入字面量 %。完整的转换说明符必须是 %%。
n
(C99) 		写入换行符
t
(C99) 		写入水平制表符
年
Y 将年份写入为十进制数字，例如 2017 tm_year
EY
(C99) 		以替代表示形式写入年份，例如在 ja_JP 区域设置中是 平成23年（Heisei 23 年）而不是 2011年 tm_year
y 将年份的后两位数字写入为十进制数字（范围 [00,99]） tm_year
Oy
(C99) 		使用替代数字系统写入年份的后两位数字，例如在 ja_JP 区域设置中是 十一 而不是 11 tm_year
Ey
(C99) 		将年份写入为区域设置替代日历周期 %EC 的偏移量（取决于区域设置） tm_year
C
(C99) 		将年份的前两位数字写入为十进制数字（范围 [00,99]） tm_year
EC
(C99) 		以区域设置的替代表示形式写入基准年份（周期）的名称，例如在 ja_JP 中是 平成（Heisei 时代） tm_year
G
(C99) 		写入 ISO 8601 基于周的年份，即包含指定周的年份。

在ISO 8601中，周以星期一开始，一年的第一周必须满足以下要求

  • 包含1月4日
  • 包含一年中的第一个星期四
 tm_year, tm_wday, tm_yday
g
(C99) 		写入 ISO 8601 基于周的年份的后两位数字，即包含指定周的年份（范围 [00,99]）。

在ISO 8601中，周以星期一开始，一年的第一周必须满足以下要求

  • 包含1月4日
  • 包含一年中的第一个星期四
 tm_year, tm_wday, tm_yday
月
b 写入月份缩写名称，例如 Oct（取决于区域设置） tm_mon
Ob
(C23) 		在区域设置的替代表示中写入缩写月份名称 tm_mon
h
(C99) 		b 的同义词 tm_mon
B 写入月份全称名称，例如 October（取决于区域设置） tm_mon
OB
(C23) 		在区域设置的替代表示中写入适当的完整月份名称 tm_mon
m 将月份写入为十进制数字（范围 [01,12]） tm_mon
Om
(C99) 		使用替代数字系统写入月份，例如在 ja_JP 区域设置中是 十二 而不是 12 tm_mon
周
U 将年份的周数写入为十进制数字（星期日是一周的第一天）（范围 [00,53]） tm_year, tm_wday, tm_yday
OU
(C99) 		使用替代数字系统写入年份的周数，如 %U 所定义，例如在 ja_JP 区域设置中是 五十二 而不是 52 tm_year, tm_wday, tm_yday
W 将年份的周数写入为十进制数字（星期一是一周的第一天）（范围 [00,53]） tm_year, tm_wday, tm_yday
OW
(C99) 		使用替代数字系统写入年份的周数，如 %W 所定义，例如在 ja_JP 区域设置中是 五十二 而不是 52 tm_year, tm_wday, tm_yday
V
(C99) 		写入 ISO 8601 年份的周数（范围 [01,53]）。

在ISO 8601中，周以星期一开始，一年的第一周必须满足以下要求

  • 包含1月4日
  • 包含一年中的第一个星期四
 tm_year, tm_wday, tm_yday
OV
(C99) 		使用替代数字系统写入年份的周数，如 %V 所定义，例如在 ja_JP 区域设置中是 五十二 而不是 52 tm_year, tm_wday, tm_yday
年/月中的日
j 将年份中的天数写入为十进制数字（范围 [001,366]） tm_yday
d 将月份中的天数写入为十进制数字（范围 [01,31]） tm_mday
Od
(C99) 		使用替代数字系统写入基于零的月份中的天数，例如在 ja_JP 区域设置中是 二十七 而不是 27

单个字符前面有一个空格。

 tm_mday
e
(C99) 		将月份中的天数写入为十进制数字（范围 [1,31]）。

单个数字前面有一个空格。

 tm_mday
Oe
(C99) 		使用替代数字系统写入基于一的月份中的天数，例如在 ja_JP 区域设置中是 二十七 而不是 27

单个字符前面有一个空格。

 tm_mday
星期几
a 写入星期几缩写名称，例如 Fri（取决于区域设置） tm_wday
A 写入星期几全称名称，例如 Friday（取决于区域设置） tm_wday
w 将星期几写入为十进制数字，其中星期日是 0（范围 [0-6]） tm_wday
Ow
(C99) 		使用替代数字系统写入星期几，其中星期日是 0，例如在 ja_JP 区域设置中是 二 而不是 2 tm_wday
u
(C99) 		将星期几写入为十进制数字，其中星期一是 1（ISO 8601 格式）（范围 [1-7]） tm_wday
Ou
(C99) 		使用替代数字系统写入星期几，其中星期一是 1，例如在 ja_JP 区域设置中是 二 而不是 2 tm_wday
时、分、秒
H 将小时写入为十进制数字，24 小时制（范围 [00-23]） tm_hour
OH
(C99) 		使用替代数字系统写入 24 小时制小时，例如在 ja_JP 区域设置中是 十八 而不是 18 tm_hour
I 将小时写入为十进制数字，12 小时制（范围 [01,12]） tm_hour
OI
(C99) 		使用替代数字系统写入 12 小时制小时，例如在 ja_JP 区域设置中是 六 而不是 06 tm_hour
M 将分钟写入为十进制数字（范围 [00,59]） tm_min
OM
(C99) 		使用替代数字系统写入分钟，例如在 ja_JP 区域设置中是 二十五 而不是 25 tm_min
S 将秒写入为十进制数字（范围 [00,60]） tm_sec
OS
(C99) 		使用替代数字系统写入秒，例如在 ja_JP 区域设置中是 二十四 而不是 24 tm_sec
其他
c 写入标准日期和时间字符串，例如 Sun Oct 17 04:41:13 2010（取决于区域设置） all
Ec
(C99) 		写入替代日期和时间字符串，例如在 ja_JP 区域设置中使用 平成23年（Heisei 23 年）而不是 2011年 all
x 写入本地化日期表示（取决于区域设置） all
Ex
(C99) 		写入替代日期表示，例如在 ja_JP 区域设置中使用 平成23年（Heisei 23 年）而不是 2011年 all
X 写入本地化时间表示，例如 18:40:20 或 6:40:20 PM（取决于区域设置） all
EX
(C99) 		写入替代时间表示（取决于区域设置） all
D
(C99) 		等价于 "%m/%d/%y" tm_mon, tm_mday, tm_year
F
(C99) 		等价于 "%Y-%m-%d"（ISO 8601 日期格式） tm_mon, tm_mday, tm_year
r
(C99) 		写入本地化 12 小时制时间（取决于区域设置） tm_hour, tm_min, tm_sec
R
(C99) 		等价于 "%H:%M" tm_hour, tm_min
T
(C99) 		等价于 "%H:%M:%S"（ISO 8601 时间格式） tm_hour, tm_min, tm_sec
p 写入本地化 a.m. 或 p.m.（取决于区域设置） tm_hour
z
(C99) 		以 ISO 8601 格式写入 UTC 偏移量（例如 -0430），如果时区信息不可用则不写入任何字符 tm_isdst
Z 写入取决于区域设置的时区名称或缩写，如果时区信息不可用则不写入任何字符 tm_isdst

[编辑] 返回值

成功时，写入到由 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秒

[编辑] 参考

  • C23 标准 (ISO/IEC 9899:2024)
  • 7.29.5.1 wcsftime 函数 (p: 待定)
  • C17 标准 (ISO/IEC 9899:2018)
  • 7.29.5.1 wcsftime 函数 (p: 230-231)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.29.5.1 wcsftime 函数 (p: 439-440)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.24.5.1 wcsftime 函数 (p: 385-386)

[编辑] 另请参阅

 将 tm 对象转换为自定义文本表示形式
(函数) [编辑]
C++ 文档 中的 wcsftime
取自 "https://cppreference.cn/mwiki/index.php?title=c/chrono/wcsftime&oldid=172274"