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,
                 constchar*          format, conststructtm*          tp );
(C99 前)
size_t strftime(char*restrict str, size_t count,
                 constchar*restrict format, conststructtm*restrict tp );
(C99 起)

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

目录

[编辑]参数

str - 指向待输出 char 数组首元素的指针
count - 最大写入字节数
format - 指向指定转换格式的空终止多字节字符串指针。
tp - 指向指定待格式化时间的 structtm 对象

[编辑]格式字符串

格式字符串由零或更多个说明符和（除 % 外的）普通字符构成。所有普通字符，包括空终止字符，都会被复制到输出字符串而不加修改。每个转换说明符都始于 % 字符，可选地跟随 E 或 O 修饰符（若本地环境不支持则忽略之），后随决定说明符行为的字符。下列格式说明符可用：

转换
说明符 		解释 使用的域
% 写字面的 %。完整转换说明必须是 %%。
n
(C99)		 写换行符
t
(C99)		 写水平制表符
年
Y 以十进制数写年，如 2017 tm_year
EY
(C99)		 以替用方式写年。例如在 ja_JP 本地环境中，以“平成23年”取代“2011年” tm_year
y 写年的末 2 位十进制数（范围 [00,99]） tm_year
Oy
(C99)		 以替用数字系统写年的末 2 位数字。例如在 ja_JP 本地环境中以“十一”取代“11” tm_year
Ey
(C99)		 将年写作从本地环境的替用日历时代 %EC 的偏移（依赖本地环境） tm_year
C
(C99)		 写年的首 2 位十进制数（范围 [00,99]） tm_year
EC
(C99)		 以本地环境的替用表示写年号（时代），例如 ja_JP 中的“平成” tm_year
G
(C99)		 写ISO 8601 基于星期的年，即是包含指定星期的年份。

IS0 8601 中星期以星期一开始，而且一年的首星期必须满足下列要求：

  • 包含 1 月 4 日
  • 包含一年的首个星期四
tm_year, tm_wday, tm_yday
g
(C99)		 写ISO 8601 基于星期的年，即是包含指定星期年份，的后 2 位数（范围 [00,99]）

IS0 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 的年的星期（范围[00,53]）

IS0 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)		 以十进制数写月的第几日（范围[01,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 本地环境中“六”取代“6” 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年”取代“2011年” 全部
x 写本地化的日期表示（依赖本地环境） 全部
Ex
(C99)		 写替用日期表示。例如 ja_JP 本地环境中“平成23年”取代“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 写本地化的 a.m. 或 p.m.（依赖本地环境） tm_hour
z
(C99)		 以 ISO 8601 格式（例如 -0430）写距 UTC 的偏移，或者倘若时区信息不可用则不写字符 tm_isdst
Z 写依赖本地环境的时区名或缩写，或者若时区信息不可用则不写字符 tm_isdst

[编辑]返回值

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

[编辑]示例

运行此代码
#include <locale.h>#include <stdio.h>#include <time.h>   int main(void){char buff[70];structtm 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);elseputs("strftime failed");   setlocale(LC_TIME, "el_GR.utf8");   if(strftime(buff, sizeof buff, "%A %c", &my_time))puts(buff);elseputs("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 The strftime function （第 TBD 页）
  • C17 标准（ISO/IEC 9899:2018）：
  • 7.27.3.5 The strftime function （第 288-291 页）
  • C11 标准（ISO/IEC 9899:2011）：
  • 7.27.3.5 The strftime function （第 394-397 页）
  • C99 标准（ISO/IEC 9899:1999）：
  • 7.23.3.5 The strftime function （第 343-347 页）
  • C89/C90 标准（ISO/IEC 9899:1990）：
  • 4.12.3.5 The strftime function

[编辑]参阅

(C23 弃用)(C11)
 将 struct tm 对象转换成文本表示
(函数)[编辑]
(C23 弃用)(C11)
 将 struct time_t 对象转换成文本表示
(函数)[编辑]
(C95)
 将 struct tm 对象转换成自定义宽字符文本表示
(函数)[编辑]
strftime 的 C++ 文档
来自“https://zh.cppreference.com/mwiki/index.php?title=c/chrono/strftime&oldid=80342”
close