1. 程式人生 > >Linux下C/C++時間函式詳解

Linux下C/C++時間函式詳解

一、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 }
複製程式碼