std:: strftime
|
定义于头文件
<ctime>
|
||
|
std::
size_t
strftime
(
char
*
str,
std::
size_t
count,
const
char
*
format,
const
std::
tm
*
tp
)
;
|
||
将给定日历时间 tp 中的日期和时间信息按照 格式字符串 format 转换为以空字符结尾的多字节字符串 str 。最多写入 count 个字节。
目录 |
参数
| str | - | 指向用于输出的字符数组首元素的指针 |
| count | - | 最大写入字节数 |
| format | - | 指向以空字符结尾的多字节字符串的指针,该字符串指定 转换格式 |
| tp | - | 指向包含待转换日期时间信息的对象的指针 |
格式字符串
格式字符串由零个或多个转换说明符和普通字符(除
%
外)组成。所有普通字符(包括终止空字符)会不经修改地复制到输出字符串中。每个转换说明以
%
字符开始,可选地后跟
E
或
O
修饰符(若区域设置不支持则忽略),最后是决定说明符行为的字符。可用的格式说明符如下:
|
转换
说明符 |
说明 | 使用字段 |
|---|---|---|
%
|
写入字面量
%
。完整转换规范必须为
%%
。
|
|
n
(C++11) |
写入换行符 | |
t
(C++11) |
写入水平制表符 | |
| 年份 | ||
Y
|
将 年份 写作十进制数字,例如 2017 |
tm_year
|
EY
(C++11) |
以替代表示法写入 年份 ,例如在 ja_JP 区域设置中写作平成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 中的"平成" |
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) |
使用替代数字系统写入从一开始的
月份中的日
,例如在 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年而非2011年 | 全部 |
x
|
写入本地化的 | |
返回值
成功时写入到 str 所指向字符数组的字节数,不包括终止符 ' \0 ' 。如果在完整字符串存储完成前达到 count 限制,则返回 0 且内容不确定。
示例
#include <ctime> #include <iostream> #include <iterator> #include <locale> void utcExample() { // 非常流行的 RFC 3339 格式 UTC 时间示例 std::time_t time = std::time({}); char timeString[std::size("yyyy-mm-ddThh:mm:ssZ")]; std::strftime(std::data(timeString), std::size(timeString), "%FT%TZ", std::gmtime(&time)); std::cout << timeString << '\n'; } int main() { std::time_t t = std::time(nullptr); char mbstr[100]; if (std::strftime(mbstr, sizeof(mbstr), "%A %c", std::localtime(&t))) std::cout << mbstr << '\n'; std::locale::global(std::locale("ja_JP.utf8")); if (std::strftime(mbstr, sizeof(mbstr), "%A %c", std::localtime(&t))) std::cout << mbstr << '\n'; utcExample(); }
可能的输出:
Tuesday Tue Sep 7 19:40:35 2021 火曜日 2021年09月07日 19時40分35秒 2021-09-07T19:40:35Z
参见
|
将
std::tm
对象转换为文本表示形式
(函数) |
|
|
将
std::time_t
对象转换为文本表示形式
(函数) |
|
|
将
std::tm
对象转换为自定义宽字符串文本表示形式
(函数) |
|
|
(C++11)
|
根据指定格式格式化并输出日期/时间值
(函数模板) |
hh_mm_ss
的格式化支持
(类模板特化) |
|
|
C 文档
关于
strftime
|
|