std:: wcsftime
|
定义于头文件
<cwchar>
|
||
|
std::
size_t
wcsftime
(
wchar_t
*
str,
std::
size_t
count,
const
wchar_t
*
format,
const
std::
tm
*
time
)
;
|
||
将给定日历时间 time 中的日期和时间信息按照 格式字符串 format 转换为以空字符结尾的宽字符字符串 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
|
将年份的最后两位数字以十进制数形式写入（范围
[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 locale 中的平成（平成纪元） |
tm_year
|
G
(C++11) |
写入
ISO 8601 基于周的年份
，即包含指定周的年份。
在 ISO 8601 标准中，周从周一开始，且年份的第一周必须满足以下要求：
|
tm_year
、
tm_wday
、
tm_yday
|
g
(C++11) |
写入
ISO 8601 基于周的年份
的最后两位数字，即包含指定周的年份（范围
[00,99]
）。
在 ISO 8601 标准中，周从周一开始，且年份的第一周必须满足以下要求：
|
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 标准中，周从周一开始，且年份的第一周必须满足以下要求：
|
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) |
使用替代数字系统写入基于1的
月份中的日期
，例如在ja_JP区域设置中使用"二十七"而非27
单个字符前会添加空格。 |
tm_mday
|
| 星期几 | ||
a
|
写入
缩写星期名
，例如
Fri
（取决于区域设置）
|
tm_wday
|
A
|
输出
完整星期名称
，例如
Friday
（取决于区域设置）
|
tm_wday
|
w
|
将
weekday
写作十进制数字，其中周日为
0
（范围
[0-6]
）
|
tm_wday
|
Ow
(C++11) |
写入使用替代数字系统的
星期几
，其中周日为
0
，例如在 ja_JP 区域设置中显示为"二"而非"2"
|
tm_wday
|
u
(C++11) |
将
weekday
以十进制数字形式输出，其中周一为
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
|
将
hour
写作十进制数字，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年 替代 2011年 | 全部 |
x
|
写入本地化的 日期表示 （依赖于区域设置） | 全部 |
Ex
(C++11) |
写入 替代日期表示形式 ，例如在 ja_JP 区域设置中使用 平成23年 替代 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) |
以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秒
另请参阅
|
将
std::tm
对象转换为自定义文本表示
(函数) |
|
|
(C++11)
|
根据指定格式格式化并输出日期/时间值
(函数模板) |
|
C 文档
关于
wcsftime
|
|