std::wcsftime

 

C++

编译器支持

独立和宿主式

语言

标准库

标准库头文件

具名要求

特性测试宏 (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年（平成 23 年）而不是 2011年（2011 年）	tm_year
y	将年份的最后 2 位数字写入为十进制数字（范围 [00,99]）	tm_year
Oy (C++11)	使用替代数字系统写入年份的最后 2 位数字，例如在 ja_JP 区域设置中，十一而不是 11	tm_year
Ey (C++11)	将年份写入为相对于区域设置的替代日历期间 %EC 的偏移量（取决于区域设置）	tm_year
C (C++11)	将年份的前 2 位数字写入为十进制数字（范围 [00,99]）	tm_year
EC (C++11)	以区域设置的替代表示形式写入基年（期间）的名称，例如 ja_JP 中的 平成（平成时代）	tm_year
G (C++11)	写入 ISO 8601 基于周的年份，即包含指定周的年份。 在 ISO 8601 中，周从星期一开始，并且一年的第一周必须满足以下要求 包含 1 月 4 日 包含一年中的第一个星期四	tm_year, tm_wday, tm_yday
g (C++11)	写入 ISO 8601 基于周的年份的最后 2 位数字，即包含指定周的年份（范围 [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年（平成 23 年）而不是 2011年（2011 年）	all
x	写入本地化的日期表示形式（取决于区域设置）	all
Ex (C++11)	写入替代日期表示形式，例如在 ja_JP 区域设置中使用 平成23年（平成 23 年）而不是 2011年（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	写入本地化的上午或下午（取决于区域设置）	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 文档 for wcsftime