strftime

参数

ptr

指向结果 C 字符串的存储区的指针。

maxsize

ptr 中可复制的最大字符数，包括终止的空字符。

format

C 字符串，包含任意组合的普通字符和特殊格式说明符。这些格式说明符将被函数替换为 timeptr 指定时间的相应值。它们都以百分号 (%) 开始，具体如下：

说明符	替换为	示例
%a	星期缩写名称 *	周四
%A	星期全称 *	星期四
%b	月份缩写名称 *	八月
%B	月份全称 *	八月
%c	日期和时间表示 *	2001年8月23日星期四 14:55:02
%C	年份除以 100 并截断为整数 (00-99)	20
%d	月份的第几天，零填充 (01-31)	23
%D	简写 MM/DD/YY 日期，等同于 %m/%d/%y	08/23/01
%e	月份的第几天，空格填充 ( 1-31)	23
%F	简写 YYYY-MM-DD 日期，等同于 %Y-%m-%d	2001-08-23
%g	基于周的年份，最后两位数字 (00-99)	01
%G	基于周的年份	2001
%h	月份缩写名称 * (与 %b 相同)	八月
%H	24 小时制的小时 (00-23)	14
%I	12 小时制的小时 (01-12)	02
%j	一年中的第几天 (001-366)	235
%m	月份的十进制数 (01-12)	08
%M	分钟 (00-59)	55
%n	换行符 ('\n')
%p	上午或下午的标识	下午
%r	12 小时制时钟时间 *	02:55:02 下午
%R	24 小时制 HH:MM 时间，等同于 %H:%M	14:55
%S	秒 (00-61)	02
%t	水平制表符 ('\t')
%T	ISO 8601 时间格式 (HH:MM:SS)，等同于 %H:%M:%S	14:55:02
%u	ISO 8601 星期几，以周一为 1 (1-7)	4
%U	周数，以第一个星期日为第一个星期一的第一天 (00-53)	33
%V	ISO 8601 周数 (01-53)	34
%w	星期几的十进制数，以周日为 0 (0-6)	4
%W	周数，以第一个星期一为第一个星期一的第一天 (00-53)	34
%x	日期表示 *	08/23/01
%X	时间表示 *	14:55:02
%y	年份，最后两位数字 (00-99)	01
%Y	年份	2001
%z	ISO 8601 时区与 UTC 的偏移量 (1 分钟=1，1 小时=100) 如果无法确定时区，则不输出任何字符	+100
%Z	时区名称或缩写 * 如果无法确定时区，则不输出任何字符	CDT
%%	一个百分号 (%)	%

* 标有星号 (*) 的说明符是区域设置相关的。
注意：黄色行表示 C99 引入的说明符和子说明符。自 C99 起，两个与区域设置相关的修饰符也可以插入在百分号 (%) 和说明符本身之间，以便在适用时请求替代格式。

修饰符	含义	适用于
E	使用区域设置的替代表示法	%Ec %EC %Ex %EX %Ey %EY
O	使用区域设置的替代数字符号	%Od %Oe %OH %OI %Om %OM %OS %Ou %OU %OV %Ow %OW %Oy

timeptr

指向一个 tm 结构体的指针，该结构体包含一个分解为其各组成部分的日历时间（请参见 struct tm）。

返回值

兼容性

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

/* strftime example */
#include <stdio.h>      /* puts */
#include <time.h>       /* time_t, struct tm, time, localtime, strftime */

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;
  char buffer [80];

  time (&rawtime);
  timeinfo = localtime (&rawtime);

  strftime (buffer,80,"Now it's %I:%M%p.",timeinfo);
  puts (buffer);

  return 0;
}

Now it's 03:21PM.

数据竞争

异常 (C++)

另见

ctime

将 time_t 值转换为字符串 (函数)

asctime

将 tm 结构体转换为字符串 (函数)