命名空间
变体
操作

strftime

来自 cppreference.com
< c‎ | chrono
 
C
 
日期和时间实用程序
函数
时间操作
(C11)
(C23)
格式转换
(C23 中已弃用)(C11)
(C23 中已弃用)(C11)
strftime
(C95)
(C23)(C11)
(C23)(C11)
常量
类型
(C11)
 
定义在头文件 <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，将日期和时间信息转换为以空字符结尾的多字节字符字符串 str，格式为 格式字符串 format。最多写入 count 个字节。

内容

[编辑] 参数

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

[编辑] 格式字符串

格式字符串由零个或多个转换说明符和普通字符（% 除外）组成。所有普通字符（包括终止空字符）都将被复制到输出字符串中，而不进行修改。每个转换说明符都以 % 字符开头，可以选择后跟 E 或 O 修饰符（如果区域设置不支持，则忽略），最后是决定说明符行为的字符。以下是可用的格式说明符

转换
说明符		 说明 使用的字段
% 写入文字 %。完整的转换说明符必须为 %%。
n
(C99) 		写入换行符
t
(C99) 		写入水平制表符
年份
Y 将年份写成十进制数字，例如 2017 tm_year
EY
(C99) 		使用备用表示法写入年份，例如 ja_JP 区域设置中为平成23年（Heisei 年 23）而不是 2011年（年 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 纪年） 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
(C99) 		写入备用日期和时间字符串，例如 ja_JP 区域设置中使用平成23年（Heisei 年 23）而不是 2011年（年 2011） 所有
x 写入本地化的日期表示（区域设置相关） 所有
Ex
(C99) 		写入备用日期表示，例如 ja_JP 区域设置中使用平成23年（Heisei 年 23）而不是 2011年（年 2011） 所有
X 写入本地化的时间表示，例如 18:40:20 或 6:40:20 PM（区域设置相关） 所有
EX
(C99) 		写入备用时间表示（区域设置相关） 所有
D
(C99) 		等效于 "%m/%d/%y" tm_mon, tm_mday, tm_year
F
(C99) 		等效于 "%Y-%m-%d"（ISO 8601 日期格式） tm_mon, tm_mday, tm_year
r
(C99) 		写入本地化的12 小时制时间（区域设置相关） tm_hour, tm_min, tm_sec
R
(C99) 		等效于 "%H:%M" tm_hour, tm_min
T
(C99) 		等效于 "%H:%M:%S"（ISO 8601 时间格式） tm_hour, tm_min, tm_sec
p 写入本地化的上午或下午（区域设置相关） tm_hour
z
(C99) 		使用 ISO 8601 格式写入与 UTC 的偏移量（例如 -0430），如果时区信息不可用，则不写入任何字符 tm_isdst
Z 写入区域设置相关的时区名称或缩写，如果时区信息不可用，则不写入任何字符 tm_isdst

[编辑] 返回值

成功时写入由 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, // = year 2012
                          .tm_mon=9,    // = 10th month
                          .tm_mday=9,   // = 9th day
                          .tm_hour=8,   // = 8 hours
                          .tm_min=10,   // = 10 minutes
                          .tm_sec=20    // = 20 secs
    };
 
    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 函数 (p: 288-291)
  • C11 标准 (ISO/IEC 9899:2011)
  • 7.27.3.5 strftime 函数 (p: 394-397)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.23.3.5 strftime 函数 (p: 343-347)
  • C89/C90 标准 (ISO/IEC 9899:1990)
  • 4.12.3.5 strftime 函数

[编辑] 另请参阅

(C23 中已弃用)(C11)
 将 tm 对象转换为文本表示形式
(函数) [编辑]
(C23 中已弃用)(C11)
 将 time_t 对象转换为文本表示形式
(函数) [编辑]
(C95)
 将 tm 对象转换为自定义宽字符串文本表示形式
(函数) [编辑]
C++ 文档 for strftime
取自 "https://cppreference.cn/mwiki/index.php?title=c/chrono/strftime&oldid=153187"