命名空间
变体
操作

std::strftime

来自 cppreference.com
< cpp‎ | chrono‎ | c
 
C++
 
实用工具库
语言支持
类型支持 (基本类型，RTTI)
库功能测试宏 (C++20)
动态内存管理
程序实用工具
协程支持 (C++20)
可变参数函数
(C++20)
(C++26)
(C++11)
(C++20)
调试支持
(C++26)
(C++26)
(C++26)
三向比较
(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++11)
关系运算符 (C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换 和 类型操作
(C++20)
(C++14)
(C++11)
(C++23)
(C++11)
(C++23)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++11)
(C++17)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)
(C++17)

 
日期和时间实用工具
时间点
(C++11)
(C++20)
持续时间
(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)
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* tp );

根据给定的日历时间 tp，按照 格式字符串 format 将日期和时间信息转换为以 null 结尾的多字节字符字符串 str。最多写入 count 个字节。

内容

[编辑] 参数

str - 指向用于输出的 char 数组的第一个元素的指针
count - 要写入的最大字节数
format - 指向以 null 结尾的多字节字符字符串的指针，该字符串指定 转换格式
tp - 指向包含要转换的日期和时间信息的对象的指针

[编辑] 格式字符串

格式字符串由零个或多个转换说明符和普通字符（除 % 外）组成。所有普通字符（包括结束 null 字符）都将被复制到输出字符串中，不会进行修改。每个转换说明符都以 % 字符开头，后面可以选择 E 或 O 修饰符（如果本地不支持，则忽略），然后是确定说明符行为的字符。以下格式说明符可用

转换
说明符		 说明 使用的字段
% 写入文字 %。完整的转换说明符必须为 %%。
n
(C++11) 		写入换行符
t
(C++11) 		写入水平制表符
年份
Y 以十进制数字写入年份，例如 2017 tm_year
EY
(C++11) 		以替代表示形式写入年份，例如在 ja_JP 本地中，写入 平成23年 (Heisei 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 中写入 平成 (Heisei 年号) tm_year
G
(C++11) 		写入ISO 8601 基于周的年份，即包含指定周的年份。

在 ISO 8601 中，周从星期一开始，一年中的第一周必须满足以下要求

  • 包括 1 月 4 日
  • 包括一年中的第一个星期四
 tm_year、tm_wday、tm_yday
g
(C++11) 		写入ISO 8601 基于周的年份的后两位数字，即包含指定周的年份（范围 [00,99]）。

在 ISO 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 年份中的周数（范围 [01,53]）。

在 ISO 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) 		以十进制数字写入一个月中的天数（范围 [1,31]）。

单个数字前面有一个空格。

 tm_mday
Oe
(C++11) 		使用备用数字系统写入以 1 为基的月份中的日期，例如在 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年（平成 23 年）而不是 2011年（2011 年） 所有
x 写入本地化的日期表示（取决于本地化） 所有
Ex
(C++11) 		写入备用日期表示，例如在 ja_JP 本地化中使用 平成23年（平成 23 年）而不是 2011年（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 指示的字符数组中的字节数，不包括终止的 '\0'，如果成功。如果在整个字符串可以存储之前就达到了 count，则返回 ​0​，内容是不确定的。

[编辑] 示例

运行此代码
#include <ctime>
#include <iostream>
#include <iterator>
#include <locale>
 
void utcExample()
{
    // Example of the very popular RFC 3339 format UTC time
    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)
 根据指定的格式格式化并输出日期/时间值
(函数模板) [编辑]
(C++20)
 对 hh_mm_ss 的格式化支持
(类模板特化) [编辑]
C 文档 用于 strftime
从 "https://cppreference.cn/mwiki/index.php?title=cpp/chrono/c/strftime&oldid=161518" 检索