Linux时间函数的API

目录

 

Linux时间函数总结

常用的的时间结构体总结

常用的时间函数介绍：

---

• Linux时间函数总结

　　最近做APUE项目用到的时间函数比较频繁，就总结了Linux下常用的获取时间的函数有如下几个：

　　 asctime,  ctime, gmtime, localtime, gettimeofday ，inumktime, asctime_r, ctime_r, gmtime_r, localtime_r

• 常用的的时间结构体总结

1.struct tm 

struct tm {
               int tm_sec;         // tm_sec 代表目前秒数，正常范围为0-59，但允许至61秒
               int tm_min;         // tm_min 代表目前分数，范围0-59
               int tm_hour;        // tm_hour 从午夜算起的时数，范围为0-23
               int tm_mday;        // tm_mday 目前月份的日数，范围01-31
               int tm_mon;         // month int tm_mon 代表目前月份，从一月算起，范围从0-11，使用一般会+1 就可以达到1-12
               int tm_year;        // tm_year 从1900 年算起至今的年数
               int tm_wday;        // tm_wday 一星期的日数，从星期一算起，范围为0-6，使用一般会+1 就可以达到1-7
               int tm_yday;        // int tm_yday 从今年1月1日算起至今的天数，范围为0-365
               int tm_isdst;       // 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() 函数获取当前时间

   #include <time.h>
   time_t time(time_t *t);  
   
   /* 此函数会返回从公元1970年1月1日的UTC时间从0时0分0秒算起到现在所经过的秒数。
    * 如果t 并非空指针的话，此函数也会将返回值存到t指针所指的内存。
    */

   实例代码：

   #include <stdio.h>
   #include <string.h>
   #include <time.h>
   
   int main()
   {
       time_t sec;
   
       sec = time((time_t *)NULL);
       printf("%d\n", (int)sec);
   
       return 0;
   }

    运行结果：

   

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是线程安全的**/

   实例代码：

   #include <stdio.h>
   #include <string.h>
   #include <time.h>
   
   int main()
   {
       time_t tmp;   
       struct tm *timp; 
      
       time(&tmp);   
       timp = localtime(&tmp);
      
       printf("%d-%d-%d %d:%d:%d\n", (1900 + timp->tm_year), ( 1 + timp->tm_mon), timp->tm_mday,
                                   (timp->tm_hour), timp->tm_min, timp->tm_sec); 
   
       return 0;
   }

   运行结果： 

    

    

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 将时间以换为字符串字符串格式返回 
    */

    实例代码：

   #include <stdio.h>
   #include <string.h>
   #include <time.h> 
     
   int main() 
   {   
       time_t timp;   
       time(&timp);
      
       printf("%s\n", asctime(gmtime(&timp)));   
       
       return 0;
   }

    运行结果：(asctime获取的字符串自己带有换行符)

    

    

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结构中的信息转换成真实世界所使用的时间日期表示方法，
    *然后将结果以字符串形态返回
    */

    实例代码： 

   #include <stdio.h>
   #include <string.h>
   #include <time.h>   
   
   int main(void)   
   {   
       time_t tmp;
    
       time(&tmp);   
       printf("%s\n", ctime(&tmp));
       
       return 0;  
   }

   运行结果：(ctime获取的字符串自己带有换行符)

    

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

    #include <time.h>
    time_t mktime(struct tm *tm);
   
   /*
    *将时间结构体struct tm的值转化为经过的秒数
    */

   实例代码 ：

   #include <stdio.h>
   #include <string.h>
   #include <time.h>  
    
   int main()   
   {   
       time_t tmp;   
       struct tm *timp;   
   
       time(&tmp);   
       timp = localtime(&tmp);   
       tmp = mktime(timp);
      
       printf("%d\n", (int)tmp);   
       
       return 0;
   }

   运行结果：

   

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
    */

   实例代码： 

   #include <stdio.h>
   #include <string.h>
   #include <sys/time.h>
   
   int main()
   {
       struct timeval tv; 
       
       gettimeofday(&tv, NULL);
   
       printf("tv_sec = %d\n", (int)tv.tv_sec);
       printf("tv_usec = %d\n", (int)tv.tv_usec);
       
       return 0;
   }

   运行结果：