一、Linux函数总结
最近的工作中用到的时间函数比较频繁,今天抽时间总结一下,在linux下,常用的获取时间的函数有如下几个:
asctime, ctime, gmtime, localtime, gettimeofday ,
mktime, asctime_r, ctime_r, gmtime_r, localtime_r
二、常用的结构体
(1)struct tm ;
1 struct tm { 2 int tm_sec; /* seconds */ 3 int tm_min; /* minutes */ 4 int tm_hour; /* hours */ 5 int tm_mday; /* day of the month */ 6 int tm_mon; /* month */ 7 int tm_year; /* year */ 8 int tm_wday; /* day of the week */ 9 int tm_yday; /* day in the year */ 10 int tm_isdst; /* daylight saving time */ 11 }; 12 13 //int tm_sec 代表目前秒数,正常范围为0-59,但允许至61秒 14 //int tm_min 代表目前分数,范围0-59 15 //int tm_hour 从午夜算起的时数,范围为0-23 16 //int tm_mday 目前月份的日数,范围01-31 17 //int tm_mon 代表目前月份,从一月算起,范围从0-11 18 //int tm_year 从1900 年算起至今的年数 19 //int tm_wday 一星期的日数,从星期一算起,范围为0-6 20 //int tm_yday 从今年1月1日算起至今的天数,范围为0-365 21 //int tm_isdst 日光节约时间的旗标
(2)struct timeval,struct timezone;
1 struct timeval { 2 time_t tv_sec; /* seconds (秒)*/ 3 suseconds_t tv_usec; /* microseconds(微秒) */ 4 }; 5 struct timezone { 6 int tz_minuteswest; /* minutes west of Greenwich */ 7 int tz_dsttime; /* type of DST correction */ 8 }; 9 int tz_minuteswest; /* 格林威治时间往西方的时差 */ 10 int tz_dsttime; /* 时间的修正方式*/
三、时间函数介绍:
(1)time() 函数获取当前时间
1 SYNOPSIS 2 #include <time.h> 3 4 time_t time(time_t *t); 5 6 DESCRIPTION 7 time() returns the time as the number of seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC). 8 //此函数会返回从公元1970年1月1日的UTC时间从0时0分0秒算起到现在所经过的秒数。如果t 并非空指针的话,此函数也会将返回值存到t指针所指的内存。 9 RETURN VALUE 10 On success, the value of time in seconds since the Epoch is returned. On error, ((time_t) -1) is returned, and errno is 11 set appropriately. 12 ERRORS 13 EFAULT t points outside your accessible address space. 14 //成功返回秒数,错误则返回(time_t) -1),错误原因存于errno中
eg:
1 #include <stdio.h> 2 #include <string.h> 3 #include <time.h> 4 5 int main() 6 { 7 time_t seconds; 8 9 seconds = time((time_t *)NULL); 10 printf("%d\n", seconds); 11 12 return 0; 13 }
(2)localtime_r() localtime()取得当地目前时间和日期
函数原型如下:
1 #include <time.h> 2 3 struct tm *localtime(const time_t *timep); 4 struct tm *localtime_r(const time_t *timep, struct tm *result); 5 6 /*该函数将有time函数获取的值timep转换真实世界所使用的时间日期表示方法,然后将结果由结构tm返回*/ 7 8 /**需要注意的是localtime函数可以将时间转换本地时间,但是localtime函数不是线程安全的。 9 多线程应用里面,应该用localtime_r函数替代localtime函数,因为localtime_r是线程安全的**/
eg:
1 #include <stdio.h> 2 #include <string.h> 3 #include <time.h> 4 5 int main() 6 { 7 time_t timep; 8 struct tm *p; 9 10 time(&timep); 11 p = localtime(&timep); 12 13 printf("%d-%d-%d %d:%d:%d\n", (1900 + p->tm_year), ( 1 + p->tm_mon), p->tm_mday, 14 (p->tm_hour + 12), p->tm_min, p->tm_sec); 15 16 return 0; 17 }
(3)asctime() asctime_r() 将时间和日期以字符串格式返回‘
函数原型如下:
1 #include <time.h> 2 3 struct tm *gmtime(const time_t *timep); 4 struct tm *gmtime_r(const time_t *timep, struct tm *result); 5 6 char *asctime(const struct tm *tm); 7 char *asctime_r(const struct tm *tm, char *buf); 8 9 10 /**gmtime是把日期和时间转换为格林威治(GMT)时间的函数。将参数time 所指的time_t 结构中的信息转换成真实世界所使用的时间日期表示方法,然后将结果由结构tm返回**/ 11 12 /**asctime 将时间以换为字符串字符串格式返回 **/
eg:
1 #include <stdio.h> 2 #include <string.h> 3 #include <time.h> 4 5 int main() 6 { 7 time_t timep; 8 time(&timep); 9 10 printf("%s\n", asctime(gmtime(&timep))); 11 12 return 0; 13 }
(4) ctime(),ctime_r() 将时间和日期以字符串格式表示
函数原型如下:
1 #include <time.h> 2 3 char *ctime(const time_t *timep); 4 char *ctime_r(const time_t *timep, char *buf); 5 6 /**ctime()将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法,然后将结果以字符串形态返回**/
eg:
1 #include <stdio.h> 2 #include <string.h> 3 #include <time.h> 4 5 int main(void) 6 { 7 time_t timep; 8 9 time(&timep); 10 printf("%s\n", ctime(&timep)); 11 12 return 0; 13 }
(5)mktime() 将时间结构体struct tm的值转化为经过的秒数
函数原型:
1 #include <time.h> 2 3 time_t mktime(struct tm *tm); 4 5 /**将时间结构体struct tm的值转化为经过的秒数**/
eg:
1 #include <stdio.h> 2 #include <string.h> 3 #include <time.h> 4 5 int main() 6 { 7 time_t timep; 8 struct tm *p; 9 10 time(&timep); 11 p = localtime(&timep); 12 timep = mktime(p); 13 14 printf("%d\n", timep); 15 16 return 0; 17 }
**最后结果可以看出mktime转化后的时间与time函数获取的一样**
(6)gettimeofday() 获取当前时间
函数原型如下:
1 #include <sys/time.h> 2 3 int gettimeofday(struct timeval *tv, struct timezone *tz); 4 5 struct timeval { 6 time_t tv_sec; /* seconds (秒)*/ 7 suseconds_t tv_usec; /* microseconds(微秒) */ 8 }; 9 struct timezone { 10 int tz_minuteswest; /* minutes west of Greenwich */ 11 int tz_dsttime; /* type of DST correction */ 12 }; 13 //gettimeofday函数获取当前时间存于tv结构体中,相应的时区信息则存于tz结构体中 14 //需要注意的是tz是依赖于系统,不同的系统可能存在获取不到的可能,因此通常设置为NULL
eg:
1 #include <stdio.h> 2 #include <string.h> 3 #include <sys/time.h> 4 5 int main() 6 { 7 struct timeval tv; 8 9 gettimeofday(&tv, NULL); 10 11 printf("tv_sec: %d\n", tv.tv_sec); 12 printf("tv_usec: %d\n", tv.tv_usec); 13 14 return 0; 15 }