命名空间
变体
操作

std::wcsftime

来自 cppreference.com
< cpp‎ | chrono‎ | c
 
C++
 
实用程序库
语言支持
类型支持 (基本类型，RTTI)
库特性测试宏 (C++20)
动态内存管理
程序实用程序
协程支持 (C++20)
可变参数函数
(C++20)
(C++26)
(C++11)
(C++20)
调试支持
(C++26)
(C++26)
(C++26)
三路比较
(C++20)(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)   
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用程序
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换 和 类型操作
(C++20)
(C++14)
(C++11)
(C++23)
(C++11)
(C++23)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++11)
(C++17)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)
(C++17)

 
日期和时间实用程序
时间点
(C++11)
(C++20)
持续时间
(C++11)
时钟
(C++11)
(C++11)
(C++20)
(C++20)
(C++20)
(C++20)
一天中的时间
(C++20)(C++20)
(C++20)(C++20)
(C++20)

日历
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)(C++20)
时区
(C++20)
(C++20)
(C++20)(C++20)(C++20)(C++20)  
(C++20)
chrono I/O
(C++20)
C 样式日期和时间
 
C 样式日期和时间实用程序
函数
时间操作
(C++17)
格式转换
wcsftime
常量
类型
(C++17)
 
定义在头文件 <cwchar> 中
std::size_t wcsftime( wchar_t* str, std::size_t count, const wchar_t* format, const std::tm* time );

根据给定的日历时间 time 将日期和时间信息转换为以空字符结尾的宽字符字符串 str，符合 格式字符串 format。最多写入 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 将年的后两位写为十进制数（范围 [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 中的平成（平成时代） 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（取决于语言环境） 全部
Ec
(C++11) 		写入备用日期和时间字符串，例如在 ja_JP 语言环境中使用 平成23年 (year Heisei 23) 而不是 2011年 (year 2011) 全部
x 写入本地化的日期表示（取决于语言环境） 全部
Ex
(C++11) 		写入备用日期表示，例如在 ja_JP 语言环境中使用 平成23年 (year Heisei 23) 而不是 2011年 (year 2011) 全部
X 写入本地化的时间表示，例如 18:40:20 或 6:40:20 PM（取决于语言环境） 全部
EX
(C++11) 		写入备用时间表示（取决于语言环境） 全部
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) 		写入与 UTC 的偏移量，采用 ISO 8601 格式（例如-0430），如果时间区信息不可用，则不写任何字符 tm_isdst
Z 写入与语言环境相关的时区名称或缩写，如果时间区信息不可用，则不写任何字符 tm_isdst

[edit] 返回值

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

[edit] 示例

运行此代码
#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秒

[edit] 另请参见

 将 std::tm 对象转换为自定义文本表示
(函数) [edit]
(C++11)
 根据指定的格式格式化并输出日期/时间值
(函数模板) [edit]
C 文档 用于 wcsftime
检索自 "https://cppreference.cn/mwiki/index.php?title=cpp/chrono/c/wcsftime&oldid=157053"