↓推薦關(guān)注↓

日期和時(shí)間是編程中非常常用的功能。本文是對(duì)C 11到C 17中相關(guān)編程接口的介紹。

介紹

C 中可以使用的日期時(shí)間API主要分為兩類(lèi)：

• C-style 日期時(shí)間庫(kù)，位于頭文件中。這是原先頭文件的C 版本。
• chrono庫(kù)：C 11中新增API，增加了時(shí)間點(diǎn)，時(shí)長(zhǎng)和時(shí)鐘等相關(guān)接口。

在C 11之前，C 編程只能使用C-style日期時(shí)間庫(kù)。其精度只有秒級(jí)別，這對(duì)于有高精度要求的程序來(lái)說(shuō)，是不夠的。

但這個(gè)問(wèn)題在C 11中得到了解決，C 11中不僅擴(kuò)展了對(duì)于精度的要求，也為不同系統(tǒng)的時(shí)間要求提供了支持。

另一方面，對(duì)于只能使用C-style日期時(shí)間庫(kù)的程序來(lái)說(shuō)，C 17中也增加了timespec將精度提升到了納秒級(jí)別。

代碼示例

本文中所貼出的代碼示例可以到我的Github上獲取：paulQuei/cpp-date-time^[1]。

或者，你也可以直接通過(guò)下面這條命令獲取所有源碼：

git?clone?https://github.com/paulQuei/cpp-date-time.git
為了簡(jiǎn)化書(shū)寫(xiě)，本文中給出的代碼都已經(jīng)默認(rèn)做了以下操作：

#include?
#include?
#include?

using?namespace?std;


C-style 日期時(shí)間庫(kù)

C-style 日期時(shí)間庫(kù)中包含的函數(shù)和數(shù)據(jù)類(lèi)型說(shuō)明如下：

函數(shù)

函數(shù)	說(shuō)明
std::clock_t clock()	返回自程序啟動(dòng)時(shí)起的處理器時(shí)鐘時(shí)間
std::time_t time(std::time_t* arg)	返回自紀(jì)元起計(jì)的系統(tǒng)當(dāng)前時(shí)間
double difftime(std::time_t time_end, ? std::time_t time_beg)	計(jì)算時(shí)間之間的差
int timespec_get(std::timespec* ts, int base)??	返回基于給定時(shí)間基底的日歷時(shí)間
char* ctime(const std::time_t* time)	轉(zhuǎn)換 time_t 對(duì)象為文本表示
char* asctime(const std::tm* time_ptr)	轉(zhuǎn)換 tm 對(duì)象為文本表示
std::size_t strftime(char* str, ? std::size_t count, const char* format, ? const std::tm* time)	轉(zhuǎn)換 tm 對(duì)象到自定義的文本表示
std::size_t wcsftime( wchar_t* str, ? std::size_t count, const wchar_t* format, ? const std::tm* time)	轉(zhuǎn)換 tm 對(duì)象為定制的寬字符串文本表示
std::tm* gmtime(const std::time_t* time)	將time_t轉(zhuǎn)換成UTC表示的時(shí)間
std::tm* localtime(const std::time_t *time)	將time_t轉(zhuǎn)換成本地時(shí)間
std::time_t mktime(std::tm* time)	將tm格式的時(shí)間轉(zhuǎn)換成time_t表示的時(shí)間

數(shù)據(jù)類(lèi)型

名稱(chēng)	說(shuō)明
time_t	從紀(jì)元起的時(shí)間類(lèi)型
tm	日歷時(shí)間類(lèi)型
timespec??	以秒和納秒表示的時(shí)間
clock_t	進(jìn)程運(yùn)行時(shí)間
size_t	sizeof 運(yùn)算符返回的無(wú)符號(hào)整數(shù)類(lèi)型

結(jié)構(gòu)梳理

這里有不少的函數(shù)和數(shù)據(jù)類(lèi)型，剛開(kāi)始接觸的時(shí)候似乎不太容易記得住。

但實(shí)際上，如果我們把它們畫(huà)成一張圖就比較好理解了，如下所示：

在這幅圖中，以數(shù)據(jù)類(lèi)型為中心，帶方向的實(shí)線箭頭表示該函數(shù)能返回相應(yīng)類(lèi)型的結(jié)果。

• clock函數(shù)是相對(duì)獨(dú)立的一個(gè)函數(shù)，它返回進(jìn)程運(yùn)行的時(shí)間，具體描述見(jiàn)下文。
• time_t描述了紀(jì)元時(shí)間，通過(guò)time函數(shù)可以獲得它。但它只能精確到秒級(jí)別。
• timespec類(lèi)型在time_t的基礎(chǔ)上，增加了納秒的精度，通過(guò)timespec_get獲取。這是C 17上新增的
• tm是日歷類(lèi)型，因?yàn)樗渲邪四暝氯盏刃畔?。通過(guò)gmtime，localtime和mktime函數(shù)可以將time_t和tm類(lèi)型互相轉(zhuǎn)換。
• 考慮到時(shí)區(qū)的差異，因此存在gmtime和localtime兩個(gè)函數(shù)。
• 無(wú)論是time_t還是tm結(jié)構(gòu)，都可以將其以字符串格式輸出。ctime和asctime輸出的格式是固定的。如果需要自定義格式，需要使用strftime或者wcsftime函數(shù)。

進(jìn)程運(yùn)行時(shí)間

clock函數(shù)返回進(jìn)程迄今為止所用的處理器時(shí)間。單獨(dú)調(diào)度該函數(shù)一次所返回的值是沒(méi)有意義的，只有兩次不同值的差才有意義。

該值表示了進(jìn)程從關(guān)聯(lián)到程序執(zhí)行的實(shí)現(xiàn)定義時(shí)期開(kāi)始，所用的粗略處理器時(shí)間。而且這個(gè)值僅僅是處理器的時(shí)鐘周期。如果希望將其轉(zhuǎn)換為以秒為單位，還需要將它除以常量 CLOCKS_PER_SEC 。

下面是一段代碼示例：

clock_t?time1?=?clock();
double?sum?=?0;
for(int?i?=?0;?i???sum? =?sqrt(i);
}
clock_t?time2?=?clock();

double?t?=?((double)(time2?-?time1))?/?CLOCKS_PER_SEC?;
cout?<"CLOCKS_PER_SEC:?"?<cout?<"Process?running?time:?"?<"s"?<其輸出如下：

CLOCKS_PER_SEC:?1000000
Process?running?time:?0.80067s
你可能知道，現(xiàn)代的操作系統(tǒng)上進(jìn)程都是分時(shí)占用處理器的，所以程序的處理器時(shí)間會(huì)小于真實(shí)世界流逝的時(shí)間。但這僅僅是對(duì)于單處理器而言的。在多處理器系統(tǒng)上，如果你的進(jìn)程使用了多線程，那么其所用的處理器時(shí)間可能比真實(shí)世界流逝的時(shí)間值還要大。

關(guān)于紀(jì)元時(shí)間

紀(jì)元時(shí)間（Epoch time）又叫做Unix時(shí)間或者POSIX時(shí)間。它表示自1970 年 1 月 1 日 00:00 UTC 以來(lái)所經(jīng)過(guò)的秒數(shù)（不考慮閏秒）。它在操作系統(tǒng)和文件格式中被廣泛使用。

這個(gè)想法很簡(jiǎn)單：以一個(gè)時(shí)間為起點(diǎn)加上一個(gè)偏移量便可以表達(dá)任何一個(gè)其他的時(shí)間。

如果你好奇為什么選這個(gè)時(shí)間作為起點(diǎn)，可以點(diǎn)擊這里：Why is 1/1/1970 the “epoch time”?^[2]。

下面是一個(gè)代碼示例：

time_t?epoch_time?=?time(nullptr);
cout?<"Epoch?time:?"?<其輸出如下：

Epoch?time:?1577433897
time函數(shù)接受一個(gè)指針，指向要存儲(chǔ)時(shí)間的對(duì)象，通?？梢詡鬟f一個(gè)空指針，然后通過(guò)返回值來(lái)接受結(jié)果。

雖然標(biāo)準(zhǔn)中沒(méi)有給出定義，但time_t通常使用整形值來(lái)實(shí)現(xiàn)。

作為一個(gè)程序員，你可能馬上會(huì)意識(shí)到整形的位數(shù)和溢出的問(wèn)題。事實(shí)也剛好是這樣，在一些歷史實(shí)現(xiàn)上使用了32位有符號(hào)整數(shù)來(lái)實(shí)現(xiàn)time_t，其造成的結(jié)果就是：在2038-01-19 03:14:07^[3]這個(gè)時(shí)間點(diǎn)，這個(gè)值會(huì)溢出。

不過(guò)不用擔(dān)心太多，這個(gè)時(shí)間距現(xiàn)在還有將近20年，到那個(gè)時(shí)候，估計(jì)那些有問(wèn)題的系統(tǒng)已經(jīng)不會(huì)再繼續(xù)運(yùn)轉(zhuǎn)或者已經(jīng)被升級(jí)了。

計(jì)算時(shí)間差

在一些情況下，我們需要計(jì)算一個(gè)操作的時(shí)間長(zhǎng)度。這自然的就需要計(jì)算兩個(gè)時(shí)間點(diǎn)的差分。這時(shí)就可以使用difftime函數(shù)。

事實(shí)上，我們知道time_t以秒級(jí)別表示紀(jì)元時(shí)間，并且它又是以整形實(shí)現(xiàn)的，直接將兩個(gè)time_t相減，可以得到相同的結(jié)果。

下面是一個(gè)代碼示例：

time_t?time1?=?time(nullptr);
double?sum?=?0;
for(int?i?=?0;?i???sum? =?sqrt(i);
}
time_t?time2?=?time(nullptr);

double?time_diff?=?difftime(time2,?time1);
cout?<"time1:?"?<cout?<"time2:?"?<cout?<"time_diff:?"?<"s"?<其輸出如下，可以看到這正是time1和time2兩個(gè)整數(shù)相減的結(jié)果：

time1:?1577434406
time2:?1577434414
time_diff:?8s


注意：time_t只精確到秒，它無(wú)法描述毫秒級(jí)別的時(shí)間，所以在有更高精度要求的情況下，需要使用下文提到的其他方法。

輸出時(shí)間和日期

當(dāng)然，我們還希望將時(shí)間以字符串的形式打印出來(lái)。這時(shí)就可以使用ctime函數(shù)。不過(guò)該函數(shù)打印的格式是固定的：Www Mmm dd hh:mm:ss yyyy\n。如果你希望自定義輸出的格式，可以使用下文提到的其他方法。

下面是一個(gè)代碼示例：

time_t?now?=?time(nullptr);
cout?<"Now?is:?"?<

欲知詳情，請(qǐng)下載word文檔 下載文檔