std::strftime

 

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)

 

在标头 <ctime> 定义
std::size_t strftime(char* str, std::size_t count, constchar* format, conststd::tm* tp );

按照格式字符串format，转换来自给定的日历时间 tp 的日期和时间信息，为空终止多字节字符串 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	写年的末 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 基于星期的年，即是包含指定星期的年份。 IS0 8601 中星期以星期一开始，而且一年的首星期必须满足下列要求： 包含 1 月 4 日 包含一年的首个星期四	tm_year, tm_wday, tm_yday
g (C++11)	写ISO 8601 基于星期的年，即是包含指定星期年份，的后 2 位数（范围 [00,99]） IS0 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 的年的星期（范围[00,53]） IS0 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)	以十进制数写月的第几日（范围[01,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 本地环境中“六”取代“6”	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	写本地化的 a.m. 或 p.m.（依赖本地环境）	tm_hour
z (C++11)	以 ISO 8601 格式（例如 -0430）写距 UTC 的偏移，或者倘若时区信息不可用则不写字符	tm_isdst
Z	写依赖本地环境的时区名或缩写，或者若时区信息不可用则不写字符	tm_isdst

返回值

成功时，返回写入 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

See also

asctime	转换 std::tm 对象为文本表示 (函数)
ctime	转换 std::time_t 对象为文本表示 (函数)
wcsftime	转换 std::tm 对象为自定义的宽字符串文本表示 (函数)
put_time (C++11)	按照指定格式格式化并输出日期/时间值 (函数模板)
std::formatter<std::chrono::hh_mm_ss> (C++20)	hh_mm_ss 的格式化支持 (类模板特化)
strftime 的 C 文档