C語言time.h函數庫
2007-04-26 20:15
C/C++中的日期和時間 頭檔案 time.h 函數用途 函數名 得到處理器時間 clock 得到時間差 difftime 設定時間 mktime 得到時間 time 得到以ASCII碼表示的時間 asctime 得到字元串表示的時間 ctime 得到指定格式的時間 strftime 摘要: 本文從介紹基礎概念入手,探讨了在C/C++中對日期和時間操作所用到的資料結構和函數,并對計時、時間的擷取、時間的計算和顯示格式等方面進行了闡述。本文還通過大量的執行個體向你展示了time.h頭檔案中聲明的各種函數和資料結構的詳細使用方法。 關鍵字: UTC(世界标準時間),Calendar Time(月曆時間),epoch(時間點),clock tick(時鐘計時單元) 1.概念 在C/C++中,對字元串的操作有很多值得注意的問題,同樣,C/C++對時間的操作也有許多值得大家注意的地方。最近,在技術群中有很多網友也多次問到 過C++語言中對時間的操作、擷取和顯示等等的問題。下面,在這篇文章中,筆者将主要介紹在C/C++中時間和日期的使用方法. 通過學習許多C/C++庫,你可以有很多操作、使用時間的方法。但在這之前你需要了解一些“時間”和“日期”的概念,主要有以下幾個: Coordinated Universal Time(UTC):協調世界時,又稱為世界标準時間,也就是大家所熟知的格林威治标準時間 (Greenwich Mean Time,GMT)。比如,中國内地的時間與UTC的時差為+8,也就是UTC+8。美國是UTC-5。 Calendar Time:月曆時間,是用“從一個标準時間點到此時的時間經過的秒數”來表示的時間。這個标準時間點對不同的編譯器來說會有所不同,但 對一個編譯系統來說,這個标準時間點是不變的,該編譯系統中的時間對應的月曆時間都通過該标準時間點來衡量,是以可以說月曆時間是“相對時間”,但是無論 你在哪一個時區,在同一時刻對同一個标準時間點來說,月曆時間都是一樣的。 epoch:時間點。時間點在标準C/C++中是一個整數,它用此時的時間和标準時間點相差的秒數(即月曆時間)來表示。 clock tick:時鐘計時單元(而不把它叫做時鐘滴答次數),一個時鐘計時單元的時間長短是由CPU控制的。一個clock tick不是CPU的一個時鐘周期,而是C/C++的一個基本計時機關。 我們可以使用ANSI标準庫中的time.h頭檔案。這個頭檔案中定義的時間和日期所使用的方法,無論是在結構定義,還是命名,都具有明顯的C語言風格。下面,我将說明在C/C++中怎樣使用日期的時間功能。 2. 計時 C/C++中的計時函數是clock(),而與其相關的資料類型是clock_t。在MSDN中,查得對clock函數定義如下: clock_t clock( void ); 這個函數傳回從“開啟這個程式程序”到“程式中調用clock()函數”時之間的CPU時鐘計時單元(clock tick)數,在MSDN中稱之為挂鐘 時間(wal-clock)。其中clock_t是用來儲存時間的資料類型,在time.h檔案中,我們可以找到對它的定義: #ifndef _CLOCK_T_DEFINED typedef long clock_t; #define _CLOCK_T_DEFINED #endif 很明顯,clock_t是一個長整形數。在time.h檔案中,還定義了一個常量CLOCKS_PER_SEC,它用來表示一秒鐘會有多少個時鐘計時單元,其定義如下: #define CLOCKS_PER_SEC ((clock_t)1000) 可以看到每過千分之一秒(1毫秒),調用clock()函數傳回的值就加1。下面舉個例子,你可以使用公式clock()/CLOCKS_PER_SEC來計算一個程序自身的運作時間: void elapsed_time() { printf("Elapsed time:%u secs./n",clock()/CLOCKS_PER_SEC); } 當然,你也可以用clock函數來計算你的機器運作一個循環或者處理其它事件到底花了多少時間: #include “stdio.h” #include “stdlib.h” #include “time.h” int main( void ) { long i = 10000000L; clock_t start, finish; double duration; /* 測量一個事件持續的時間*/ printf( "Time to do %ld empty loops is ", i ); start = clock(); while( i-- ) finish = clock(); duration = (double)(finish - start) / CLOCKS_PER_SEC; printf( "%f seconds/n", duration ); system("pause"); } 在筆者的機器上,運作結果如下: Time to do 10000000 empty loops is 0.03000 seconds 上面我們看到時鐘計時單元的長度為1毫秒,那麼計時的精度也為1毫秒,那麼我們可不可以通過改變CLOCKS_PER_SEC的定義,通過把它定義的大一些,進而使計時精度更高呢?通過嘗試,你會發現這樣是不行的。在标準C/C++中,最小的計時機關是一毫秒。 3.與日期和時間相關的資料結構 在标準C/C++中,我們可通過tm結構來獲得日期和時間,tm結構在time.h中的定義如下: #ifndef _TM_DEFINED 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代表一月) - 取值區間為[0,11] */ int tm_year; /* 年份,其值等于實際年份減去1900 */ int tm_wday; /* 星期 – 取值區間為[0,6],其中0代表星期天,1代表星期一,以此類推 */ int tm_yday; /* 從每年的1月1日開始的天數 – 取值區間為[0,365],其中0代表1月1日,1代表1月2日,以此類推 */ int tm_isdst; /* 夏令時辨別符,實行夏令時的時候,tm_isdst為正。不實行夏令時的進候,tm_isdst為0;不了解情況時,tm_isdst()為負。*/ }; #define _TM_DEFINED #endif ANSI C标準稱使用tm結構的這種時間表示為分解時間(broken-down time)。而月曆時間(Calendar Time)是通過 time_t資料類型來表示的,用time_t表示的時間(月曆時間)是從一個時間點(例如:1970年1月1日0時0分0秒)到此時的秒數。在 time.h中,我們也可以看到time_t是一個長整型數: #ifndef _TIME_T_DEFINED typedef long time_t; /* 時間值 */ #define _TIME_T_DEFINED /* 避免重複定義 time_t */ #endif 大家可能會産生疑問:既然time_t實際上是長整型,到未來的某一天,從一個時間點(一般是1970年1月1日0時0分0秒)到那時的秒數(即月曆時 間)超出了長整形所能表示的數的範圍怎麼辦?對time_t資料類型的值來說,它所表示的時間不能晚于2038年1月18日19時14分07秒。為了能夠 表示更久遠的時間,一些編譯器廠商引入了64位甚至更長的整形數來儲存月曆時間。比如微軟在Visual C++中采用了__time64_t資料類型來 儲存月曆時間,并通過_time64()函數來獲得月曆時間(而不是通過使用32位字的time()函數),這樣就可以通過該資料類型儲存3001年1月 1日0時0分0秒(不包括該時間點)之前的時間。 在time.h頭檔案中,我們還可以看到一些函數,它們都是以time_t為參數類型或傳回值類型的函數: double difftime(time_t time1, time_t time0); time_t mktime(struct tm * timeptr); time_t time(time_t * timer); char * asctime(const struct tm * timeptr); char * ctime(const time_t *timer); 此外,time.h還提供了兩種不同的函數将月曆時間(一個用time_t表示的整數)轉換為我們平時看到的把年月日時分秒分開顯示的時間格式tm: struct tm * gmtime(const time_t *timer); struct tm * localtime(const time_t * timer); 通過查閱MSDN,我們可以知道Microsoft C/C++ 7.0中時間點的值(time_t對象的值)是從1899年12月31日0時0分0秒到 該時間點所經過的秒數,而其它各種版本的Microsoft C/C++和所有不同版本的Visual C++都是計算的從1970年1月1日0時0分0 秒到該時間點所經過的秒數。 4.與日期和時間相關的函數及應用 在本節,我将向大家展示怎樣利用time.h中聲明的函數對時間進行操作。這些操作包括取目前時間、計算時間間隔、以不同的形式顯示時間等内容。 4.1 獲得月曆時間 我們可以通過time()函數來獲得月曆時間(Calendar Time),其原型為:time_t time(time_t * timer); 如果你已經聲明了參數timer,你可以從參數timer傳回現在的月曆時間,同時也可以通過傳回值傳回現在的月曆時間,即從一個時間點(例如:1970 年1月1日0時0分0秒)到現在此時的秒數。如果參數為空(NUL),函數将隻通過傳回值傳回現在的月曆時間,比如下面這個例子用來顯示目前的月曆時間: #include "time.h" #include "stdio.h" int main(void) { struct tm *ptr; time_t lt; lt =time(NUL); printf("The Calendar Time now is %d/n",lt); return 0; } 運作的結果與當時的時間有關,我當時運作的結果是: The Calendar Time now is 1122707619 其中1122707619就是我運作程式時的月曆時間。即從1970年1月1日0時0分0秒到此時的秒數。 4.2 獲得日期和時間 這裡說的日期和時間就是我們平時所說的年、月、日、時、分、秒等資訊。從第2節我們已經知道這些資訊都儲存在一個名為tm的結構體中,那麼如何将一個月曆時間儲存為一個tm結構的對象呢? 其中可以使用的函數是gmtime()和localtime(),這兩個函數的原型為: struct tm * gmtime(const time_t *timer); struct tm * localtime(const time_t * timer); 其中gmtime()函數是将月曆時間轉化為世界标準時間(即格林尼治時間),并傳回一個tm結構體來儲存這個時間,而localtime()函數是将日 曆時間轉化為本地時間。比如現在用gmtime()函數獲得的世界标準時間是2005年7月30日7點18分20秒,那麼我用localtime()函數 在中國地區獲得的本地時間會比世界标準時間晚8個小時,即2005年7月30日15點18分20秒。下面是個例子: #include "time.h" #include "stdio.h" int main(void) { struct tm *local; time_t t; t=time(NUL); local=localtime(&t); printf("Local hour is: %d/n",local->tm_hour); local=gmtime(&t); printf("UTC hour is: %d/n",local->tm_hour); return 0; } 運作結果是: Local hour is: 15 UTC hour is: 7 4.3 固定的時間格式 我們可以通過asctime()函數和ctime()函數将時間以固定的格式顯示出來,兩者的傳回值都是char*型的字元串。傳回的時間格式為: 星期幾 月份 日期 時:分:秒 年/n/0 例如:Wed Jan 02 02:03:55 1980/n/0 其中/n是一個換行符,/0是一個空字元,表示字元串結束。下面是兩個函數的原型: char * asctime(const struct tm * timeptr); char * ctime(const time_t *timer); 其中asctime()函數是通過tm結構來生成具有固定格式的儲存時間資訊的字元串,而ctime()是通過月曆時間來生成時間字元串。這樣的話, asctime()函數隻是把tm結構對象中的各個域填到時間字元串的相應位置就行了,而ctime()函數需要先參照本地的時間設定,把月曆時間轉化為 本地時間,然後再生成格式化後的字元串。在下面,如果t是一個非空的time_t變量的話,那麼: printf(ctime(&t)); 等價于: struct tm *ptr; ptr=localtime(&t); printf(asctime(ptr)); 那麼,下面這個程式的兩條printf語句輸出的結果就是不同的了(除非你将本地時區設為世界标準時間所在的時區): #include "time.h" #include "stdio.h" int main(void) { struct tm *ptr; time_t lt; lt =time(NUL); ptr=gmtime(<); printf(asctime(ptr)); printf(ctime(<)); return 0; } 運作結果: Sat Jul 30 08:43:03 2005 Sat Jul 30 16:43:03 2005 4.4 自定義時間格式 我們可以使用strftime()函數将時間格式化為我們想要的格式。它的原型如下: size_t strftime( char *strDest, size_t maxsize, const char *format, const struct tm *timeptr ); 我們可以根據format指向字元串中格式指令把timeptr中儲存的時間資訊放在strDest指向的字元串中,最多向strDest中存放maxsize個字元。該函數傳回向strDest指向的字元串中放置的字元數。 函數strftime()的操作有些類似于sprintf():識别以百分号(%)開始的格式指令集合,格式化輸出結果放在一個字元串中。格式化指令說明 串strDest中各種日期和時間資訊的确切表示方法。格式串中的其他字元原樣放進串中。格式指令列在下面,它們是區分大小寫的。 %a 星期幾的簡寫 %A 星期幾的全稱 %b 月分的簡寫 %B 月份的全稱 %c 标準的日期的時間串 %C 年份的後兩位數字 %d 十進制表示的每月的第幾天 %D 月/天/年 %e 在兩字元域中,十進制表示的每月的第幾天 %F 年-月-日 %g 年份的後兩位數字,使用基于周的年 %G 年分,使用基于周的年 %h 簡寫的月份名 %H 24小時制的小時 %I 12小時制的小時 %j 十進制表示的每年的第幾天 %m 十進制表示的月份 %M 十時制表示的分鐘數 %n 新行符 %p 本地的AM或PM的等價顯示 %r 12小時的時間 %R 顯示小時和分鐘:hh:mm %S 十進制的秒數 %t 水準制表符 %T 顯示時分秒:hh:mm:ss %u 每周的第幾天,星期一為第一天 (值從0到6,星期一為0) %U 第年的第幾周,把星期日做為第一天(值從0到53) %V 每年的第幾周,使用基于周的年 %w 十進制表示的星期幾(值從0到6,星期天為0) %W 每年的第幾周,把星期一做為第一天(值從0到53) %x 标準的日期串 %X 标準的時間串 %y 不帶世紀的十進制年份(值從0到99) %Y 帶世紀部分的十進制年份 %z,%Z 時區名稱,如果不能得到時區名稱則傳回空字元。 %% 百分号 如果想顯示現在是幾點了,并以12小時制顯示,就象下面這段程式: #include “time.h” #include “stdio.h” int main(void) { struct tm *ptr; time_t lt; char str[80]; lt=time(NUL); ptr=localtime(<); strftime(str,100,"It is now %I %p",ptr); printf(str); return 0; } 其運作結果為: It is now 4PM 而下面的程式則顯示目前的完整日期: #include <stdio.h> #include <time.h> void main( void ) { struct tm *newtime; char tmpbuf[128]; time_t lt1; time( <1 ); newtime=localtime(<1); strftime( tmpbuf, 128, "Today is %A, day %d of %B in the year %Y./n", newtime); printf(tmpbuf); } 運作結果: Today is Saturday, day 30 of July in the year 2005. 4.5 計算持續時間的長度 有時候在實際應用中要計算一個事件持續的時間長度,比如計算打字速度。在第1節計時部分中,我已經用clock函數舉了一個例子。Clock()函數可以精确到毫秒級。同時,我們也可以使用difftime()函數,但它隻能精确到秒。該函數的定義如下: double difftime(time_t time1, time_t time0); 雖然該函數傳回的以秒計算的時間間隔是double類型的,但這并不說明該時間具有同double一樣的精确度,這是由它的參數覺得的(time_t是以秒為機關計算的)。比如下面一段程式: #include "time.h" #include "stdio.h" #include "stdlib.h" int main(void) { time_t start,end; start = time(NUL); system("pause"); end = time(NUL); printf("The pause used %f seconds./n",difftime(end,start));//<- system("pause"); return 0; } 運作結果為: 請按任意鍵繼續. . . The pause used 2.000000 seconds. 請按任意鍵繼續. . . 可以想像,暫停的時間并不那麼巧是整整2秒鐘。其實,你将上面程式的帶有“//<-”注釋的一行用下面的一行代碼替換: printf("The pause used %f seconds./n",end-start); 其運作結果是一樣的。 4.6 分解時間轉化為月曆時間 這裡說的分解時間就是以年、月、日、時、分、秒等分量儲存的時間結構,在C/C++中是tm結構。我們可以使用mktime()函數将用tm結構表示的時間轉化為月曆時間。其函數原型如下: time_t mktime(struct tm * timeptr); 其傳回值就是轉化後的月曆時間。這樣我們就可以先制定一個分解時間,然後對這個時間進行操作了,下面的例子可以計算出1997年7月1日是星期幾: #include "time.h" #include "stdio.h" #include "stdlib.h" int main(void) { struct tm t; time_t t_of_day; t.tm_year=1997-1900; t.tm_mon=6; t.tm_mday=1; t.tm_hour=0; t.tm_min=0; t.tm_sec=1; t.tm_isdst=0; t_of_day=mktime(&t); printf(ctime(&t_of_day)); return 0; } 運作結果: Tue Jul 01 00:00:01 1997 現在注意了,有了mktime()函數,是不是我們可以操作現在之前的任何時間呢?你可以通過這種辦法算出1945年8月15号是星期幾嗎?答案是否定的。因為這個時間在1970年1月1日之前,是以在大多數編譯器中,這樣的程式雖然可以編譯通過,但運作時會異常終止。 5.總結 本文介紹了标準C/C++中的有關日期和時間的概念,并通過各種執行個體講述了這些函數和資料結構的使用方法。筆者認為,和時間相關的一些概念是相當重要的,了解這些概念是了解各種時間格式的轉換的基礎,更是應用這些函數和資料結構的基礎。 |
類别:vc++ | 添加到搜藏 | 浏覽(22)
