Linux下C语言时间函数总结

Linux C时间库函数关联关系图如下：

C 库函数 - time()

描述

　　C 库函数 time_t time(time_t *seconds) 返回自纪元 Epoch（1970-01-01 00:00:00 UTC）起经过的时间，以秒为单位。如果 seconds 不为空，则返回值也存储在变量 seconds 中。

声明

下面是 time() 函数的声明。

?

1	time_t time(time_t *t)

参数

?

1	seconds -- 这是指向类型为 time_t 的对象的指针，用来存储 seconds 的值。

返回值

以 time_t 对象返回当前日历时间。

C 库函数 - localtime()

描述

C 库函数 struct tm *localtime(const time_t *timer) 使用 timer 的值来填充 tm 结构。timer 的值被分解为 tm 结构，并用本地时区表示。

声明

下面是 localtime() 函数的声明。

?

1	struct tm *localtime(const time_t *timer)

参数

?

1	timer -- 这是指向表示日历时间的 time_t 值的指针。

返回值

该函数返回指向 tm 结构的指针，该结构带有被填充的时间信息。

?

1 2 3 4 5 6 7 8 9 10 11

struct tm {    int tm_sec;         /* 秒，范围从 0 到 59 */    int tm_min;         /* 分，范围从 0 到 59 */    int tm_hour;        /* 小时，范围从 0 到 23 */    int tm_mday;        /* 一月中的第几天，范围从 1 到 31 */    int tm_mon;         /* 月份，范围从 0 到 11 */    int tm_year;        /* 自 1900 起的年数 */    int tm_wday;        /* 一周中的第几天，范围从 0 到 6 */    int tm_yday;        /* 一年中的第几天，范围从 0 到 365 */    int tm_isdst;       /* 夏令时 */    }

C 库函数 - gmtime()

描述

C 库函数 struct tm *gmtime(const time_t *timer) 使用 timer 的值来填充 tm 结构，并用协调世界时（UTC）也被称为格林尼治标准时间（GMT）表示。

声明

下面是 gmtime() 函数的声明。

?

1	struct tm *gmtime(const time_t *timer)

参数

?

1	timeptr -- 这是指向表示日历时间的 time_t 值的指针。

返回值

该函数返回指向 tm 结构的指针，该结构带有被填充的时间信息。

C 库函数 - mktime()

　　描述

C 库函数 time_t mktime(struct tm *timeptr) 把 timeptr 所指向的结构转换为一个依据本地时区的 time_t 值。

声明

下面是 mktime() 函数的声明。

?

1	time_t mktime(struct tm *timeptr)

参数

?

1	timeptr -- 这是指向表示日历时间的 time_t 值的指针，该日历时间被分解为以下各部分。

返回值

该函数返回一个 time_t 值，该值对应于以参数传递的日历时间。如果发生错误，则返回 -1 值。

 

C 库函数 - ctime()

描述

C 库函数 char *ctime(const time_t *timer) 返回一个表示当地时间的字符串，当地时间是基于参数 timer。

返回的字符串格式如下： Www Mmm dd hh:mm:ss yyyy 其中，Www 表示星期几，Mmm 是以字母表示的月份，dd 表示一月中的第几天，hh:mm:ss 表示时间，yyyy 表示年份。

声明

下面是 ctime() 函数的声明。

?

1	char *ctime(const time_t *timer)

参数

?

1	timer -- 这是指向 time_t 对象的指针，该对象包含了一个日历时间。

返回值

该函数返回一个 C 字符串，该字符串包含了可读格式的日期和时间信息 

C 库函数 - asctime()

描述

C 库函数 char *asctime(const struct tm *timeptr) 返回一个指向字符串的指针，它代表了结构 struct timeptr 的日期和时间。

声明

下面是 asctime() 函数的声明。

?

1	char *asctime(const struct tm *timeptr)

参数

?

1	timeptr 是指向 tm 结构的指针。

返回值

该函数返回一个 C 字符串，包含了可读格式的日期和时间信息 Www Mmm dd hh:mm:ss yyyy，其中，Www 表示星期几，Mmm 是以字母表示的月份，dd 表示一月中的第几天，hh:mm:ss 表示时间，yyyy 表示年份。

C 库函数 - strftime()

描述

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

声明

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

?

1	size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)

参数

?

1 2 3 4

str -- 这是指向目标数组的指针，用来复制产生的 C 字符串。 maxsize -- 这是被复制到 str 的最大字符数。 format -- 这是 C 字符串，包含了普通字符和特殊格式说明符的任何组合。这些格式说明符由函数替换为表示 tm 中所指定时间的相对应值。 timeptr -- 这是指向 tm 结构的指针。

返回值

如果产生的 C 字符串小于 size 个字符（包括空结束字符），则会返回复制到 str 中的字符总数（不包括空结束字符），否则返回零。

具体实例如下：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34

#include <stdio.h> #include <time.h>    int main() {     time_t t_time;     struct tm *tm_time;     char *c_time;     char timestr[512] = {0};           t_time = time(NULL);           tm_time = gmtime(&t_time);           //转换成国际标准时间     printf("gmtime      : %d:%d:%d  %d:%d:%d\n", 1900+tm_time->tm_year, tm_time->tm_mon, tm_time->tm_mday, tm_time->tm_hour, tm_time->tm_min, tm_time->tm_sec);           //转换成本地时间     tm_time = localtime(&t_time);     printf("localtime   : %d:%d:%d  %d:%d:%d\n", 1900+tm_time->tm_year, tm_time->tm_mon, tm_time->tm_mday, tm_time->tm_hour, tm_time->tm_min, tm_time->tm_sec);           //转换成字符串     c_time = ctime(&t_time);     printf("ctime       : %s\n", c_time);           //转换成字符串     c_time = asctime(tm_time);     printf("asctime     : %s\n", c_time);           //格式化输出     strftime(timestr, sizeof(timestr), "%F %T", tm_time);     printf("strftime    : %s\n", timestr);           return 0;<br>}

　　

运行结果如下：