Namespaces
Variants

strftime

From cppreference.net
定义于头文件 <time.h>
size_t strftime ( char * str, size_t count,
const char * format, const struct tm * tp ) ;
(C99前)
size_t strftime ( char * restrict str, size_t count,
const char * restrict format, const struct tm * restrict tp ) ;
(C99起)

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

目录

参数

str - 指向输出 char 数组首元素的指针
count - 最大写入字节数
format - 指向以空字符结尾的多字节字符串的指针,用于指定 转换格式
tp - 指向 struct tm 对象的指针,用于指定要格式化的时间

格式字符串

格式字符串由零个或多个转换说明符和普通字符(除 % 外)组成。所有普通字符(包括终止空字符)会不经修改地复制到输出字符串中。每个转换说明以 % 字符开始,可选地后跟 E O 修饰符(若区域设置不支持则忽略),最后是决定说明符行为的字符。可用的格式说明符如下:

转换
说明符
说明 使用字段
% 写入字面量 % 。完整转换规范必须为 %%
n
(C99)
写入换行符
t
(C99)
写入水平制表符
年份
Y 年份 写作十进制数字,例如 2017 tm_year
EY
(C99)
以替代表示法写入 年份 ,例如在 ja_JP 区域设置中写作平成23年而非2011年 tm_year
y 年份 的后两位写作十进制数字(范围 [00,99] tm_year
Oy
(C99)
使用替代数字系统写入 年份 的后两位,例如在 ja_JP 区域设置中写作十一而非11 tm_year
Ey
(C99)
年份 写作相对于区域设置替代日历周期 %EC 的偏移量(区域设置相关) tm_year
C
(C99)
年份 的前两位写作十进制数字(范围 [00,99] tm_year
EC
(C99)
以区域设置的替代表示法写入 基准年(周期) 的名称,例如 ja_JP 中的平成(Heisei era) tm_year
G
(C99)
写入 ISO 8601 周制年份 ,即包含指定周的年份。

在 ISO 8601 中,周从周一开始,且一年的第一周必须满足以下要求:

  • 包含1月4日
  • 包含该年的第一个星期四
tm_year , tm_wday , tm_yday
g
(C99)
写入 ISO 8601 周制年份 的后两位,即包含指定周的年份(范围 [00,99] )。

在 ISO 8601 中,周从周一开始,且一年的第一周必须满足以下要求:

  • 包含1月4日
  • 包含该年的第一个星期四
tm_year , tm_wday , tm_yday
月份
b 写入 缩写月份 名称,例如 Oct (区域设置相关) tm_mon
Ob
(C23)
以区域设置的替代表示法写入 缩写月份 名称 tm_mon
h
(C99)
b 的同义词 tm_mon
B 写入 完整月份 名称,例如 October (区域设置相关) tm_mon
OB
(C23)
以区域设置的替代表示法写入适当的 完整月份 名称 tm_mon
m 月份 写作十进制数字(范围 [01,12] tm_mon
Om
(C99)
使用替代数字系统写入 月份 ,例如在 ja_JP 区域设置中写作十二而非12 tm_mon
U 年份中的周 写作十进制数字(周日为一周的第一天)(范围 [00,53] tm_year , tm_wday , tm_yday
OU
(C99)
使用替代数字系统写入 年份中的周 ,如 %U 所示,例如在 ja_JP 区域设置中写作五十二而非52 tm_year , tm_wday , tm_yday
W 年份中的周 写作十进制数字(周一为一周的第一天)(范围 [00,53] tm_year , tm_wday , tm_yday
OW
(C99)
使用替代数字系统写入 年份中的周 ,如 %W 所示,例如在 ja_JP 区域设置中写作五十二而非52 tm_year , tm_wday , tm_yday
V
(C99)
写入 ISO 8601 年份中的周 (范围 [01,53] )。

在 ISO 8601 中,周从周一开始,且一年的第一周必须满足以下要求:

  • 包含1月4日
  • 包含该年的第一个星期四
tm_year , tm_wday , tm_yday
OV
(C99)
使用替代数字系统写入 年份中的周 ,如 %V 所示,例如在 ja_JP 区域设置中写作五十二而非52 tm_year , tm_wday , tm_yday
年/月中的日
j 年份中的日 写作十进制数字(范围 [001,366] tm_yday
d 月份中的日 写作十进制数字(范围 [01,31] tm_mday
Od
(C99)
使用替代数字系统写入从零开始的 月份中的日 ,例如在 ja_JP 区域设置中写作二十七而非27

单个字符前会添加空格。

tm_mday
e
(C99)
月份中的日 写作十进制数字(范围 [1,31] )。

单个数字前会添加空格。

tm_mday
Oe
(C99)
使用替代数字系统写入从一开始的 月份中的日 ,例如在 ja_JP 区域设置中写作二十七而非27

单个字符前会添加空格。

tm_mday
星期几
a 写入 缩写星期几 名称,例如 Fri (区域设置相关) tm_wday
A 写入 完整星期几 名称,例如 Friday (区域设置相关) tm_wday
w 星期几 写作十进制数字,其中周日为 0 (范围 [0-6] tm_wday
Ow
(C99)
使用替代数字系统写入 星期几 ,其中周日为 0 ,例如在 ja_JP 区域设置中写作二而非2 tm_wday
u
(C99)
星期几 写作十进制数字,其中周一为 1 (ISO 8601 格式)(范围 [1-7] tm_wday
Ou
(C99)
使用替代数字系统写入 星期几 ,其中周一为 1 ,例如在 ja_JP 区域设置中写作二而非2 tm_wday
时、分、秒
H 小时 写作十进制数字,24小时制(范围 [00-23] tm_hour
OH
(C99)
使用替代数字系统写入24小时制的 小时 ,例如在 ja_JP 区域设置中写作十八而非18 tm_hour
I 小时 写作十进制数字,12小时制(范围 [01,12] tm_hour
OI
(C99)
使用替代数字系统写入12小时制的 小时 ,例如在 ja_JP 区域设置中写作六而非06 tm_hour
M 分钟 写作十进制数字(范围 [00,59] tm_min
OM
(C99)
使用替代数字系统写入 分钟 ,例如在 ja_JP 区域设置中写作二十五而非25 tm_min
S 写作十进制数字(范围 [00,60] tm_sec
OS
(C99)
使用替代数字系统写入 ,例如在 ja_JP 区域设置中写作二十四而非24 tm_sec
其他
c 写入 标准日期和时间字符串 ,例如 Sun Oct 17 04:41:13 2010 (区域设置相关) 全部
Ec
<span class="t-mark

返回值

成功时写入到由 str 指向的字符数组的字节数,不包括终止符 ' \0 ' 。如果在完整字符串存储完成前达到 count ,则返回 0 且内容不确定。

示例

#include <locale.h>
#include <stdio.h>
#include <time.h>
int main(void)
{
    char buff[70];
    struct tm my_time = { .tm_year = 112, // = 年份 2012
                          .tm_mon = 9,    // = 第10个月
                          .tm_mday = 9,   // = 第9天
                          .tm_hour = 8,   // = 8小时
                          .tm_min = 10,   // = 10分钟
                          .tm_sec = 20    // = 20秒
    };
    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");
    setlocale(LC_TIME, "el_GR.utf8");
    if (strftime(buff, sizeof buff, "%A %c", &my_time))
        puts(buff);
    else
        puts("strftime failed");
}

可能的输出:

Sunday Sun Oct  9 08:10:20 2012
Κυριακή Κυρ 09 Οκτ 2012 08:10:20 πμ EST

参考文献

  • C23 标准 (ISO/IEC 9899:2024):
  • 7.27.3.5 strftime 函数 (p: TBD)
  • C17 标准 (ISO/IEC 9899:2018):
  • 7.27.3.5 strftime 函数 (页: 288-291)
  • C11 标准 (ISO/IEC 9899:2011):
  • 7.27.3.5 strftime 函数 (页码: 394-397)
  • C99标准(ISO/IEC 9899:1999):
  • 7.23.3.5 strftime函数(页码:343-347)
  • C89/C90 标准 (ISO/IEC 9899:1990):
  • 4.12.3.5 strftime 函数

参见

(C23中已弃用) (C11)
tm 对象转换为文本表示形式
(函数)
(C23中已弃用) (C11)
time_t 对象转换为文本表示形式
(函数)
tm 对象转换为自定义宽字符串文本表示形式
(函数)
C++ 文档 for strftime