linux几种时间函数总结

一、linux时间函数总结

　　最近的工作中用到的时间函数比较频繁，今天抽时间总结一下，在linux下，常用的获取时间的函数有如下几个：

　　 asctime,  ctime, gmtime, localtime, gettimeofday ，

　　mktime, asctime_r, ctime_r, gmtime_r, localtime_r

二、常用的结构体

（1）struct tm ；

   struct tm {
                int tm_sec;         /* seconds */
                int tm_min;         /* minutes */
                int tm_hour;        /* hours */
                int tm_mday;        /* day of the month */
                int tm_mon;         /* month */
                int tm_year;        /* year */
                int tm_wday;        /* day of the week */
                int tm_yday;        /* day in the year */
                int tm_isdst;       /* daylight saving time */
            };

 //int tm_sec 代表目前秒数，正常范围为0-59，但允许至61秒
 //int tm_min 代表目前分数，范围0-59
 //int tm_hour 从午夜算起的时数，范围为0-23
 //int tm_mday 目前月份的日数，范围01-31
 //int tm_mon 代表目前月份，从一月算起，范围从0-11
 //int tm_year 从1900 年算起至今的年数
 //int tm_wday 一星期的日数，从星期一算起，范围为0-6
 //int tm_yday 从今年1月1日算起至今的天数，范围为0-365
 //int tm_isdst 日光节约时间的旗标

（2）struct timeval，struct timezone；

 struct timeval {
                time_t      tv_sec;     /* seconds (秒)*/
                suseconds_t tv_usec;    /* microseconds（微秒） */
            };
 struct timezone {
                int tz_minuteswest;     /* minutes west of Greenwich */
                int tz_dsttime;         /* type of DST correction */
            };
 int tz_minuteswest;     /* 格林威治时间往西方的时差 */
 int tz_dsttime;         /*  时间的修正方式*/    

 三、时间函数介绍：

（1）time() 函数获取当前时间

 SYNOPSIS
        #include <time.h>

        time_t time(time_t *t);

 DESCRIPTION
        time() returns the time as the number of seconds since the Epoch, -- :: + (UTC).
     //此函数会返回从公元1970年1月1日的UTC时间从0时0分0秒算起到现在所经过的秒数。如果t 并非空指针的话，此函数也会将返回值存到t指针所指的内存。
 RETURN VALUE
        On  success,  the value of time in seconds since the Epoch is returned.  On error, ((time_t) -) is returned, and errno is
        set appropriately.
 ERRORS
        EFAULT t points outside your accessible address space.
     //成功返回秒数，错误则返回(time_t) -1)，错误原因存于errno中

eg：

 #include <stdio.h>
 #include <string.h>
 #include <time.h>

 int main()
 {
     time_t seconds;

     seconds = time((time_t *)NULL);
     printf("%d\n", seconds);

     return ;
 }

（2）localtime_r() localtime()取得当地目前时间和日期

函数原型如下：

 #include <time.h>

     struct tm *localtime(const time_t *timep);
     struct tm *localtime_r(const time_t *timep, struct tm *result);

 /*该函数将有time函数获取的值timep转换真实世界所使用的时间日期表示方法，然后将结果由结构tm返回*/

 /**需要注意的是localtime函数可以将时间转换本地时间，但是localtime函数不是线程安全的。
 多线程应用里面，应该用localtime_r函数替代localtime函数，因为localtime_r是线程安全的**/

eg：

 #include <stdio.h>
 #include <string.h>
 #include <time.h>

 int main()
 {
     time_t timep;
     struct tm *p; 

     time(&timep);
     p = localtime(&timep);

     printf("%d-%d-%d %d:%d:%d\n", ( + p->tm_year), (  + p->tm_mon), p->tm_mday,
                                 (p->tm_hour + ), p->tm_min, p->tm_sec); 

     return ;
 }

（3）asctime()  asctime_r() 将时间和日期以字符串格式返回‘

函数原型如下：

 #include <time.h>

     struct tm *gmtime(const time_t *timep);
     struct tm *gmtime_r(const time_t *timep, struct tm *result);

     char *asctime(const struct tm *tm);
     char *asctime_r(const struct tm *tm, char *buf);

 /**gmtime是把日期和时间转换为格林威治(GMT)时间的函数。将参数time 所指的time_t 结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果由结构tm返回**/

 /**asctime 将时间以换为字符串字符串格式返回 **/

eg:

 #include <stdio.h>
 #include <string.h>
 #include <time.h> 

 int main()
 {
     time_t timep;
     time(&timep);

     printf("%s\n", asctime(gmtime(&timep)));   

     return ;
 } 

（4） ctime()，ctime_r() 将时间和日期以字符串格式表示

函数原型如下：

 #include <time.h>

        char *ctime(const time_t *timep);
        char *ctime_r(const time_t *timep, char *buf);

 /**ctime()将参数timep所指的time_t结构中的信息转换成真实世界所使用的时间日期表示方法，然后将结果以字符串形态返回**/

eg：

 #include <stdio.h>
 #include <string.h>
 #include <time.h>   

 int main(void)
 {
     time_t timep;

     time(&timep);
     printf("%s\n", ctime(&timep));

     return ;
 }

（5）mktime() 将时间结构体struct tm的值转化为经过的秒数

函数原型：

 #include <time.h>

     time_t mktime(struct tm *tm);

 /**将时间结构体struct tm的值转化为经过的秒数**/

eg：

 #include <stdio.h>
 #include <string.h>
 #include <time.h>  

 int main()
 {
     time_t timep;
     struct tm *p;   

     time(&timep);
     p = localtime(&timep);
     timep = mktime(p);

     printf("%d\n", timep);   

     return ;
 }

**最后结果可以看出mktime转化后的时间与time函数获取的一样**

（6）gettimeofday() 获取当前时间

函数原型如下：

 #include <sys/time.h>

     int gettimeofday(struct timeval *tv, struct timezone *tz);

 struct timeval {
                time_t      tv_sec;     /* seconds (秒)*/
                suseconds_t tv_usec;    /* microseconds（微秒） */
            };
 struct timezone {
                int tz_minuteswest;     /* minutes west of Greenwich */
                int tz_dsttime;         /* type of DST correction */
            };
 //gettimeofday函数获取当前时间存于tv结构体中，相应的时区信息则存于tz结构体中
 //需要注意的是tz是依赖于系统，不同的系统可能存在获取不到的可能，因此通常设置为NULL    

eg：

 #include <stdio.h>
 #include <string.h>
 #include <sys/time.h>

 int main()
 {
     struct timeval tv; 

     gettimeofday(&tv, NULL);

     printf("tv_sec: %d\n", tv.tv_sec);
     printf("tv_usec: %d\n", tv.tv_usec);

     return ;
 }