函数原型
#include <time.h>
size_t strftime(char *str, size_t count, const char *format, const struct tm *tm);
参数说明
- str, 表示返回的时间字符串
- count, 要写入的字节的最大数量
- format, 格式字符串由零个或多个转换符和普通字符(除%)
- tm, 输入时间
返回值
- 如果包含终止的空字符在内的结果字符的总数不大于count,则函数strftime返回字符数,这些字符被放到s指向的数组中但不包含终止的空字符。否则,函数返回零,且数组的内容不确定。
格式说明
格式符号 | 说明 |
---|---|
%a | 区域设置的缩写星期名 |
%A | 区域设置的完整星期名 |
%b | 区域设置的缩写月份名 |
%B | 区域设置的完整月份名 |
%c | 区域设置的适当的日期和时间表示 |
%d | 表示为一个十进制数(01-31)的当月的第几天 |
%H | 表示为一个十进制数(00-23)的小时时间(24小时制) |
%I | 表示为一个十进制数(01-12)的小时时间(12小时制) |
%j | 表示为一个十进制数(001-366)的当年的第几天 |
%m | 表示为一个十进制数(01-12)的月份 |
%M | 表示为一个十进制数(00-59)的分钟数 |
%p | 区域设置的、与12小时制相关的AM/PM指示符等价的东西 |
%S | 表示为一个十进制数(00-61)的秒数 |
%U | 表示为一个十进制数(00-53)的当年的第几周(第一个星期日是第一个星期的第一天) |
%w | 表示为一个十进制数(0-6)的星期几,星期日表示0 |
%W | 表示为一个十进制数(00-53)的当年的第几周(第一个星期一是第一个星期的第一天) |
%x | 区域设置的适当的日期表示 |
%X | 区域设置的适当的时间表示 |
%y | 表示为一个十进制(00-99)的不带世纪的年份 |
%Y | 表示为一个十进制的带世纪的年份 |
%Z | 时区名字或者它的缩写取代,如果不能确定时区,则不能被字符 |
%% | 表示% |
如果一个转换说明符表不是上面中的某一个,则行为未定义。
示例程序代码
#include <stdio.h>
#include <time.h>
int main()
{
time_t time_T;
time_T = time(NULL);
struct tm *tmTime;
// tm对象格式的时间
tmTime = localtime(&time_T);
printf("Now Time is: %d:%d:%d\n", (*tmTime).tm_hour, (*tmTime).tm_min, (*tmTime).tm_sec);
char* format = "%Y-%m-%d %H:%M:%S";
char strTime[100];
strftime(strTime, sizeof(strTime), format, tmTime);
printf("Time is :%s\n", strTime);
return 0;
}
// 代码结果
// Now Time is: 20:46:1
// Time is :2015-10-07 20:46:01