strftime()–C语言库函数

C库函数 size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) 格式表示的时间结构timeptr根据定义格式并存储到str格式规则。

声明

以下是strftime() 函数的声明。

size_t strftime(char*str,size_t maxsize,constchar*format,conststruct tm *timeptr)

参数

• str -- 这是C字符串复制到目标数组的指针。




• maxsize -- 这是给 str 要复制的字符的最大数目。




• format -- 这是C字符串，其中包含常规字符和特殊格式说明符的任意组合。这些格式说明符该函数相应的值代替 tm 中指定的时间来表示。格式说明符：

• timeptr -- 这是为tm结构的指针，它包含一个日历时间分解成其组成部分，如下图所示：

struct tm {int tm_sec;/* seconds, range 0 to 59 */int tm_min;/* minutes, range 0 to 59 */int tm_hour;/* hours, range 0 to 23 */int tm_mday;/* day of the month, range 1 to 31 */int tm_mon;/* month, range 0 to 11 */int tm_year;/* The number of years since 1900 */int tm_wday;/* day of the week, range 0 to 6 */int tm_yday;/* day in the year, range 0 to 365 */int tm_isdst;/* daylight saving time */};

返回值

如果C字符串适合大小的字符（包括终止空字符）小于总数的字符复制到 str（不包括终止空字符），否则返回0。

例子

下面的例子演示了如何使用strftime() 函数。

#include#includeint main (){time_t rawtime;struct tm *info;char buffer[80];
time(&rawtime );
info = localtime(&rawtime );
strftime(buffer,80,"%x - %I:%M%p", info);
printf("Formatted date & time : |%s|
", buffer );return(0);}

让我们编译和运行上面的程序，这将产生以下结果：

Formatted date & time : |08/23/12 - 12:40AM|