std::wcsftime

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

日期和时间库

时间点 time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) 时长 duration (C++11) 时钟 system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) 日间时间 is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

日历 day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono I/O parse (C++20)

时区 tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C风格日期和时间

 

C 风格日期和时间工具

函数

时间操作

difftime

time

clock

timespec_get (C++17)

格式转换

asctime

ctime

strftime

wcsftime

gmtime

localtime

mktime

常量

CLOCKS_PER_SEC

类型

tm

time_t

clock_t

timespec (C++17)

 

在头文件 <cwchar> 中定义
std::size_t wcsftime( wchar_t* str, std::size_t count, const wchar_t* format, const std::tm* time );

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

参数

str	-	指向用于输出的 wchar_t 数组第一个元素的指针
count	-	要写入的最大宽字符数
format	-	指向指定转换格式的以空字符结尾的宽字符串的指针
time	-	指向待转换日期和时间信息的指针

格式字符串

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

转换 说明符	解释	使用的字段
%	写入字面量 %。完整的转换说明符必须是 %%。
n (C++11)	写入换行符
t (C++11)	写入水平制表符
年
Y	将年份写入为十进制数字，例如 2017	tm_year
EY (C++11)	以替代表示形式写入年份，例如在 ja_JP 区域设置中是 平成23年（Heisei 23 年）而不是 2011年	tm_year
y	将年份的后两位数字写入为十进制数字（范围 [00,99]）	tm_year
Oy (C++11)	使用替代数字系统写入年份的后两位数字，例如在 ja_JP 区域设置中是 十一 而不是 11	tm_year
Ey (C++11)	将年份写入为区域设置替代日历周期 %EC 的偏移量（取决于区域设置）	tm_year
C (C++11)	将年份的前两位数字写入为十进制数字（范围 [00,99]）	tm_year
EC (C++11)	以区域设置的替代表示形式写入基准年份（周期）的名称，例如在 ja_JP 中是 平成（Heisei 时代）	tm_year
G (C++11)	写入 ISO 8601 基于周的年份，即包含指定周的年份。 在ISO 8601中，周以星期一开始，一年的第一周必须满足以下要求 包含1月4日 包含一年中的第一个星期四	tm_year, tm_wday, tm_yday
g (C++11)	写入 ISO 8601 基于周的年份的后两位数字，即包含指定周的年份（范围 [00,99]）。 在ISO 8601中，周以星期一开始，一年的第一周必须满足以下要求 包含1月4日 包含一年中的第一个星期四	tm_year, tm_wday, tm_yday
月
b	写入月份缩写名称，例如 Oct（取决于区域设置）	tm_mon
h (C++11)	b 的同义词	tm_mon
B	写入月份全称名称，例如 October（取决于区域设置）	tm_mon
m	将月份写入为十进制数字（范围 [01,12]）	tm_mon
Om (C++11)	使用替代数字系统写入月份，例如在 ja_JP 区域设置中是 十二 而不是 12	tm_mon
周
U	将年份的周数写入为十进制数字（星期日是一周的第一天）（范围 [00,53]）	tm_year, tm_wday, tm_yday
OU (C++11)	使用替代数字系统写入年份的周数，如 %U 所定义，例如在 ja_JP 区域设置中是 五十二 而不是 52	tm_year, tm_wday, tm_yday
W	将年份的周数写入为十进制数字（星期一是一周的第一天）（范围 [00,53]）	tm_year, tm_wday, tm_yday
OW (C++11)	使用替代数字系统写入年份的周数，如 %W 所定义，例如在 ja_JP 区域设置中是 五十二 而不是 52	tm_year, tm_wday, tm_yday
V (C++11)	写入 ISO 8601 年份的周数（范围 [01,53]）。 在ISO 8601中，周以星期一开始，一年的第一周必须满足以下要求 包含1月4日 包含一年中的第一个星期四	tm_year, tm_wday, tm_yday
OV (C++11)	使用替代数字系统写入年份的周数，如 %V 所定义，例如在 ja_JP 区域设置中是 五十二 而不是 52	tm_year, tm_wday, tm_yday
年/月中的日
j	将年份中的天数写入为十进制数字（范围 [001,366]）	tm_yday
d	将月份中的天数写入为十进制数字（范围 [01,31]）	tm_mday
Od (C++11)	使用替代数字系统写入基于零的月份中的天数，例如在 ja_JP 区域设置中是 二十七 而不是 27 单个字符前面有一个空格。	tm_mday
e (C++11)	将月份中的天数写入为十进制数字（范围 [1,31]）。 单个数字前面有一个空格。	tm_mday
Oe (C++11)	使用替代数字系统写入基于一的月份中的天数，例如在 ja_JP 区域设置中是 二十七 而不是 27 单个字符前面有一个空格。	tm_mday
星期几
a	写入星期几缩写名称，例如 Fri（取决于区域设置）	tm_wday
A	写入星期几全称名称，例如 Friday（取决于区域设置）	tm_wday
w	将星期几写入为十进制数字，其中星期日是 0（范围 [0-6]）	tm_wday
Ow (C++11)	使用替代数字系统写入星期几，其中星期日是 0，例如在 ja_JP 区域设置中是 二 而不是 2	tm_wday
u (C++11)	将星期几写入为十进制数字，其中星期一是 1（ISO 8601 格式）（范围 [1-7]）	tm_wday
Ou (C++11)	使用替代数字系统写入星期几，其中星期一是 1，例如在 ja_JP 区域设置中是 二 而不是 2	tm_wday
时、分、秒
H	将小时写入为十进制数字，24 小时制（范围 [00-23]）	tm_hour
OH (C++11)	使用替代数字系统写入 24 小时制小时，例如在 ja_JP 区域设置中是 十八 而不是 18	tm_hour
I	将小时写入为十进制数字，12 小时制（范围 [01,12]）	tm_hour
OI (C++11)	使用替代数字系统写入 12 小时制小时，例如在 ja_JP 区域设置中是 六 而不是 06	tm_hour
M	将分钟写入为十进制数字（范围 [00,59]）	tm_min
OM (C++11)	使用替代数字系统写入分钟，例如在 ja_JP 区域设置中是 二十五 而不是 25	tm_min
S	将秒写入为十进制数字（范围 [00,60]）	tm_sec
OS (C++11)	使用替代数字系统写入秒，例如在 ja_JP 区域设置中是 二十四 而不是 24	tm_sec
其他
c	写入标准日期和时间字符串，例如 Sun Oct 17 04:41:13 2010（取决于区域设置）	all
Ec (C++11)	写入替代日期和时间字符串，例如在 ja_JP 区域设置中使用 平成23年（Heisei 23 年）而不是 2011年	all
x	写入本地化日期表示（取决于区域设置）	all
Ex (C++11)	写入替代日期表示，例如在 ja_JP 区域设置中使用 平成23年（Heisei 23 年）而不是 2011年	all
X	写入本地化时间表示，例如 18:40:20 或 6:40:20 PM（取决于区域设置）	all
EX (C++11)	写入替代时间表示（取决于区域设置）	all
D (C++11)	等价于 "%m/%d/%y"	tm_mon, tm_mday, tm_year
F (C++11)	等价于 "%Y-%m-%d"（ISO 8601 日期格式）	tm_mon, tm_mday, tm_year
r (C++11)	写入本地化 12 小时制时间（取决于区域设置）	tm_hour, tm_min, tm_sec
R (C++11)	等价于 "%H:%M"	tm_hour, tm_min
T (C++11)	等价于 "%H:%M:%S"（ISO 8601 时间格式）	tm_hour, tm_min, tm_sec
p	写入本地化 a.m. 或 p.m.（取决于区域设置）	tm_hour
z (C++11)	以 ISO 8601 格式写入 UTC 偏移量（例如 -0430），如果时区信息不可用则不写入任何字符	tm_isdst
Z	写入取决于区域设置的时区名称或缩写，如果时区信息不可用则不写入任何字符	tm_isdst

返回值

成功时，写入到 str 指向的宽字符数组中的宽字符数，不包括终止空字符 L'\0'。如果字符串在完全存储之前达到了 count，则返回 ​0​，并且内容是未定义的。

示例

运行此代码

#include <ctime>
#include <cwchar>
#include <iostream>
#include <locale>
 
int main()
{
    std::locale::global(std::locale("ja_JP.utf8"));
    std::time_t t = std::time(nullptr);
    wchar_t wstr[100];
    if (std::wcsftime(wstr, 100, L"%A %c", std::localtime(&t)))
        std::wcout << wstr << '\n';
}

可能的输出

火曜日 2011年12月27日 17時43分13秒

参阅

strftime	将 std::tm 对象转换为自定义文本表示 (函数)
put_time (C++11)	根据指定格式格式化并输出日期/时间值 (函数模板)
C 文档 中的 wcsftime