std::strftime

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

技术规范

符号索引

外部库

 

工具库

语言支持 类型支持（基本类型、 RTTI） 库功能特性测试宏 (C++20) 动态内存管理 程序工具 协程支持 (C++20) 变参数函数 is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) 三路比较 (C++20) three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20) is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

通用工具 日期和时间 函数对象 格式化库 (C++20) bitset hash (C++11) 关系运算符 (C++20 中弃用) rel_ops::operator!=rel_ops::operator> rel_ops::operator<=rel_ops::operator>= 整数比较函数 cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20) cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) swap 与类型运算 swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) 常用词汇类型 pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23) 初等字符串转换 to_chars (C++17) from_chars (C++17) chars_format (C++17) to_chars_result (C++17) from_chars_result (C++17)

 

日期和时间工具

时间点
time_point (C++11)	clock_time_conversion (C++20)	clock_cast (C++20)
时长
duration (C++11)
时钟
system_clock (C++11) steady_clock (C++11) high_resolution_clock (C++11)	is_clock (C++20) utc_clock (C++20) tai_clock (C++20)	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)
时区
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)
chrono I/O
parse (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, const char* format, const std::tm* time );

按照格式字符串 format ，转换来自给定的日历时间 time 的日期和时间信息，为空终止多字节字符串 str 。最多写入 count 字节。

参数

str	-	指向输出用的字符数组首元素的指针
count	-	写入的最大字节数
format	-	指向空终止多字节字符串的指针，字符串指定转换格式。 格式字符串由零或更多个说明符和通常字符（除 % ）构成。所有通常字符，包括空终止字符，都会被复制到输出字符串而不加修改。每个转换说明符都始于 % 字符，可选地跟随 E 或 O 修饰符（若本地环境不支持则忽略），后随决定修饰符行为的字符。下列修饰符格式可用： 转换 说明符 解释 使用的域 % 写字面的 % 。完整转换说明必须是 %% 。 n (C++11) 写换行符 t (C++11) 写水平制表符 年 Y 以 4 位十进制数写年。 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
time	-	指向待转换日期和时间信息的指针

返回值

成功时，返回写入 str 所指向的字符数组的字节数，不包含终止 '\0' 。若在能存储整个字符串前抵达 count ，则返回 ​0​ ，写入内容是不确定的。

示例

运行此代码

#include <ctime>
#include <iostream>
#include <locale>
 
int main()
{
    std::locale::global(std::locale("ja_JP.utf8"));
    std::time_t t = std::time(NULL);
    char mbstr[100];
    if (std::strftime(mbstr, sizeof(mbstr), "%A %c", std::localtime(&t))) {
        std::cout << mbstr << '\n';
    }
}

输出：

火曜日 2011年12月27日 17時39分03秒

See also

asctime	转换 tm 对象为文本表示 (函数)
ctime	转换 time_t 对象为文本表示 (函数)
wcsftime	转换 tm 对象为定制的宽字符串文本表示 (函数)
put_time (C++11)	按照指定格式格式化并输出日期/时间值 (函数模板)