std::strftime

来自cppreference.com
< cpp‎ | chrono‎ | c
 
C++
 
工具库
通用工具
格式化库 (C++20)
(C++11)
(C++14)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++20)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)
(C++17)
(C++23)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++11)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
(C++17)
栈踪
(C++23)
(C++23)
 
日期和时间工具
时间点
(C++11)
(C++20)
时长
(C++11)
时钟
(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)(C++20)
(C++20)
chrono I/O
(C++20)
C 风格日期和时间
 
C 风格日期和时间工具
函数
时间操作
(C++17)
格式转换
strftime
常量
类型
(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

 转换 tm 对象为文本表示
(函数)
转换 time_t 对象为文本表示
(函数)
转换 tm 对象为定制的宽字符串文本表示
(函数)
(C++11)
 按照指定格式格式化并输出日期/时间值
(函数模板)
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/chrono/c/strftime&oldid=48689”