目錄

一，概述

二，C-style 日期和時間庫

2.1，數(shù)據(jù)類型

2.2，函數(shù)

2.3，數(shù)據(jù)類型與函數(shù)關(guān)系梳理

2.4，時間類型

2.5，輸出時間和日期

2.6，綜合示例代碼

三，chrono 庫

3.1，時鐘

3.2，與C-style轉(zhuǎn)換

3.3，時長 ratio

3.4，時間間隔 duration

3.5，時間點 time_point

C++11?的日期和時間編程內(nèi)容在 C++ Primer(第五版)這本書并沒有介紹，目前網(wǎng)上的文章又大多質(zhì)量堪憂或者不成系統(tǒng)，故寫下這篇文章用作自己的技術(shù)沉淀和技術(shù)分享，大部分內(nèi)容來自網(wǎng)上資料，文末也給出了參考鏈接。

日期和時間庫是每個編程語言都會提供的內(nèi)部庫，其可以用打印模塊耗時，從而方便做性能分析，也可以用作打印運行時間點。本文的內(nèi)容著重于 C++11-C++17的內(nèi)容，C++20的日期和時鐘庫雖然使用更方便也更強(qiáng)大，但是考慮到版本兼容和程序移植問題，故不做深入探討。

一，概述

C++ 中可以使用的日期時間 API 分為兩類：

C-style?日期時間庫，位于頭文件中。這是原先 頭文件的 C++ 版本。

chrono?庫：C++ 11 中新增API，增加了時間點，時長和時鐘等相關(guān)接口（使用較為復(fù)雜）。

在 C++11 之前，C++ 編程只能使用 C-style 日期時間庫，其精度只有秒級別，這對于有高精度要求的程序來說，是不夠的。但這個問題在C++11 中得到了解決，C++11 中不僅擴(kuò)展了對于精度的要求，也為不同系統(tǒng)的時間要求提供了支持。另一方面，對于只能使用 C-style 日期時間庫的程序來說，C++17 中也增加了 timespec 將精度提升到了納秒級別。

二，C-style 日期和時間庫

#include ??該頭文件包含了獲取和操作日期和時間的函數(shù)和相關(guān)數(shù)據(jù)類型定義。

2.1，數(shù)據(jù)類型

2.2，函數(shù)

C-style?日期時間庫中包含的時間操作函數(shù)如下：

時間轉(zhuǎn)換函數(shù)如下：

localtime?函數(shù)使用參數(shù)?timer?指向的值來填充?tm?結(jié)構(gòu)體，其中的值表示對應(yīng)的時間，以本地時區(qū)表示。

strftime?和?wcsftime?函數(shù)一般不常用，故不做介紹。tm?結(jié)構(gòu)體的一般定義如下：

?

/*?Used?by?other?time?functions.??*/
struct?tm
{
??int?tm_sec;???/*?Seconds.?[0-60]?(1?leap?second)?*/
??int?tm_min;???/*?Minutes.?[0-59]?*/
??int?tm_hour;???/*?Hours.?[0-23]?*/
??int?tm_mday;???/*?Day.??[1-31]?*/
??int?tm_mon;???/*?Month.?[0-11]?*/
??int?tm_year;???/*?Year?-?1900.??*/
??int?tm_wday;???/*?Day?of?week.?[0-6]?*/
??int?tm_yday;???/*?Days?in?year.[0-365]?*/
??int?tm_isdst;???/*?DST.??[-1/0/1]*/
};

?

2.3，數(shù)據(jù)類型與函數(shù)關(guān)系梳理

時間和日期相關(guān)的函數(shù)及數(shù)據(jù)類型比較多，單純看表格和代碼不是很好記憶，第一個參考鏈接的作者給出了如下所示的思維導(dǎo)圖，方便記憶與理解上面所有函數(shù)及數(shù)據(jù)類型之間各自的聯(lián)系。

思維導(dǎo)圖來源于參考鏈接的第一篇文章，后續(xù)思維導(dǎo)圖來源也是一樣，不再一一注明

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

clock?函數(shù)是相對獨立的一個函數(shù)，它返回進(jìn)程運行的時間，具體描述見下文。

time_t?描述了紀(jì)元時間，通過?time?函數(shù)可以獲得它，但它只能精確到秒級別。

timespec?類型在?time_t?的基礎(chǔ)上，增加了納秒的精度，通過?timespec_get?獲取。這是?C++17?上新增的特性。

tm?是日歷類型，因為它其中包含了年月日等信息。通過 gmtime，localtime 和 mktime 函數(shù)可以將 time_t 和 tm 類型互相轉(zhuǎn)換。

考慮到時區(qū)的差異，因此存在 gmtime 和 localtime 兩個函數(shù)。

無論是?time_t?還是?tm?結(jié)構(gòu)，都可以將其以字符串格式輸出。ctime 和 asctime 輸出的格式是固定的。如果需要自定義格式，需要使用 strftime 或者 wcsftime 函數(shù)。

2.4，時間類型

2.4.1，UTC 時間

協(xié)調(diào)世界時（Coordinated?Universial?Time，簡稱?UTC）是最主要的時間標(biāo)準(zhǔn)，其以原子時秒長為基礎(chǔ)，在時刻上盡量接近于格林威治標(biāo)準(zhǔn)時間。

協(xié)調(diào)世界時是世界上調(diào)節(jié)時鐘和時間的主要時間標(biāo)準(zhǔn)，它與0度經(jīng)線的平太陽時相差不超過 1 秒。因此UTC時間+8即可獲得北京標(biāo)準(zhǔn)時間（UTC+8）。

2.4.2，本地時間

本地時間與當(dāng)?shù)氐臅r區(qū)相關(guān)，例如中國當(dāng)?shù)貢r間采用了北京標(biāo)準(zhǔn)時間（UTC+8）。

2.4.3，紀(jì)元時間

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

紀(jì)元時間這個想法很簡單：以一個時間為起點加上一個偏移量便可以表達(dá)任何一個其他的時間。

為什么選這個時間作為起點，可以點擊這里：Why is 1/1/1970 the “epoch time”?。

通過?time?函數(shù)獲取當(dāng)前時刻的紀(jì)元時間示例代碼如下：

?

time_t?epoch_time?=?time(nullptr);
cout?<

	?

	time?函數(shù)接受一個指針，指向要存儲時間的對象，通?？梢詡鬟f一個空指針，然后通過返回值來接受結(jié)果。雖然標(biāo)準(zhǔn)中沒有給出定義，但time_t?通常使用整形值來實現(xiàn)。

	2.5，輸出時間和日期

	使用?ctime?函數(shù)，可以將時間以固定格式的字符串的形式打印出來，格式為：Www Mmm dd hhss yyyy 。代碼示例如下：

	?
//?以字符串形式輸出當(dāng)前時間和日期
time_t?now?=?time(nullptr);
cout?<

	?

	2.6，綜合示例代碼

	asctime()?和?difftime()?函數(shù)等sample?代碼如下（復(fù)制可直接運行）：

	?
/*?asctime?example?*/
#include???????/*?printf?*/
#include????????/*?time_t,?struct?tm,?time,?localtime,?asctime?*/
#include?
#include?

using?namespace?std;

//?冒泡排序:?將數(shù)據(jù)從小到大排序
void?bubbleSort(vector?&arr){
????size_t?number?=?arr.size();
????if?(number?<=?1)?return;
????int?temp;
????for(int?i?=?0;?i??arr[j+1]){
????????????????temp?=?arr[j];
????????????????arr[j]?=?arr[j+1];
????????????????arr[j+1]?=?temp;
????????????}
????????}
????}
}

//?difftime()?函數(shù):?計算時間差，單位為?s
void?difftime_test()
{
????vector?input_array;
????for?(int?i?=?90000;?i?>?0;?i--)?{
????????input_array.emplace_back(i);
????}
????time_t?time1?=?time(nullptr);
????bubbleSort(input_array);
????time_t?time2?=?time(nullptr);
????double?time_diff?=?difftime(time2,?time1);
????cout?<

	?

	g++ time_demo.cpp -std=c++11?編譯后，運行程序?./a.out?后，輸出結(jié)果：

	

	三，chrono 庫

	“chrono” 是英文 chronology 的縮寫，其含義是“年表；年代學(xué)”。

	chrono?既是頭文件名字也是子命名空間的名字，chrono?頭文件下的所有?elements?都是在?std::chrono?命名空間下定義的。

	std::chrono?是 C++11 引入的日期時間處理庫，chrono?庫里包括三種主要類型：Clocks，Time points?和?Durations?。

	

	

	3.1，時鐘

	C++11?chrono?庫中包含了三種的時鐘類：

				名稱
			

				說明
		

				chrono::system_clock
			

				系統(tǒng)時鐘（可以調(diào)整）
		

				chrono::steady_clock
			

				單調(diào)遞增時鐘（不能調(diào)整）
		

				chrono::high_resolution_clock
			

				擁有可用的最短嘀嗒周期的時鐘
		

	system_clock?是當(dāng)前所在系統(tǒng)的時鐘。因為系統(tǒng)時鐘隨時都可能被調(diào)整，所以如果想要計算兩個時間點的時間差，是不推薦使用系統(tǒng)時鐘的。

	steady_clock?會保證時間的單調(diào)遞增性，只會向前移動不會減少，所以最適合用來度量時間間隔。

	high_resolution_clock?表示實現(xiàn)提供的擁有最小計次周期的時鐘。它可以是 system_clock 或 steady_clock 的別名，也可能是第三個獨立時鐘。在不同的標(biāo)準(zhǔn)庫中，high_resolution_clock 的實現(xiàn)不一致，所以官方不建議使用這個時鐘。

	這三個時鐘類有一些共同的成員函數(shù)和數(shù)據(jù)類型，如下所示：

				名稱
			

				說明
		

				now()
			

				靜態(tài)成員函數(shù)，返回當(dāng)前時間，類型為 clock::time_point
		

				time_point
			

				成員類型，當(dāng)前時鐘的時間點類型，用于表示一個具體時間，詳情見下文“時間點”
		

				duration
			

				成員類型，時鐘的時長類型，用于表示時間間隔(一段時間)，詳情見下文“時長”
		

				rep
			

				成員類型，時鐘的 tick 類型，等同于 clock::rep
		

				period
			

				成員類型，時鐘的單位，等同于 clock::period
		

				is_steady
			

				靜態(tài)成員類型：是否是穩(wěn)定時鐘，對于 steady_clock 來說該值一定是 true
		

	每一個時鐘類都有一個?now()?靜態(tài)函數(shù)來獲取當(dāng)前時間，返回的類型由 time_*point 描述。std::time_point?是模板類，模版類實例如：std::steady\_*clock，這樣寫比較長，慶幸的是在 C++11 中可以通過?auto?關(guān)鍵字來自動推導(dǎo)變量類型。

	?
std::time_point?now1?=?std::now();
auto?now2?=?std::now();


	?

	3.2，與C-style轉(zhuǎn)換

	system_*clock 與另外兩個 clock 不一樣的地方在于，它還提供了兩個靜態(tài)函數(shù)用來將 time_*point 與 std::time_t 來回轉(zhuǎn)換。

				名稱
			

				說明
		

				to_time_t
			

				將系統(tǒng)時鐘時間點轉(zhuǎn)換為?time_t
		

				from_time_t
			

				將?time_t?轉(zhuǎn)換到系統(tǒng)時鐘時間點
		

	第一篇參考鏈接的文章給出了下面這幅圖來描述 c 風(fēng)格和 c++11 的幾種時間類型的轉(zhuǎn)換：

	

	3.3，時長 ratio

	為了支持更高精度的系統(tǒng)時鐘，C++11?新增了一個新的頭文件??和類型，用于自定義時間單位。std::ratio?是一個模板類，提供了編譯期的比例計算功能，為 std::duration 提供基礎(chǔ)服務(wù)。其聲明如下：

	?
template<
????std::intmax_t?Num,
????std::intmax_t?Denom?=?1
>?class?ratio;


	?

	第一個模板參數(shù)?Num?(numerator) 表示分子，第二個參數(shù)?Denom?(denominator) 表示分母。typedef ratio<1, 1000> milli;?表示一千分之一，因為約定了基本計算單位是秒，所以?milli?表示一千分之一秒。所以通過?ratio?可以表示毫秒、微秒、納秒等。

	?
typedef?ratio<1,1000000000>?nano;?//?納秒單位
typedef?ratio<1,1000000>?micro;?//?微秒單位
typedef?ratio<1,1000>?milli;?//?毫秒單位
typedef?ratio<1,1>?s?//?秒單位


	?

	ratio 能表達(dá)的數(shù)值不僅僅是以 10 為基底的，同時也可以表達(dá)任意的分?jǐn)?shù)秒，例如：5/7秒，89/23409 秒等等對于一個具體的 ratio 來說，可以通過 den 獲取分母的值，num 獲取分子的值。不僅僅如此，頭文件還包含了：ratio_add，ratio_subtract，ratio_multiply，ratio_divide?來完成分?jǐn)?shù)的加減乘除四則運算。例如，想要計算 5/7+59/1023，可以用以下代碼表示：

	?
ratio_add,?ratio<59,?1023>>?result;
double?value?=?((double)?result.num)?/?result.den;
cout?<

	?

	在C++中，如果分子和分母都是整形，則整形除法結(jié)果依然是整形，即小數(shù)點右邊部分會被拋棄，因此想要獲取?double?類型的結(jié)果，需要先將其轉(zhuǎn)換成?double。

	3.3.1，時長運算

	時長對象之間可以進(jìn)行相加或相減運算。chrono?提供了以下幾個常用時長運算的函數(shù)：

				函數(shù)
			

				說明
		

				duration_cast
			

				進(jìn)行時長的轉(zhuǎn)換
		

				floor（C++17）
			

				以向下取整的方式，將一個時長轉(zhuǎn)換為另一個時長
		

				ceil（C++17）
			

				以向上取整的方式，將一個時長轉(zhuǎn)換為另一個時長
		

				round（C++17）
			

				轉(zhuǎn)換時長到另一個時長，就近取整，偶數(shù)優(yōu)先
		

				abs（C++17）
			

				獲取時長的絕對值
		

	3.4，時間間隔 duration

	類模板 std::duration 表示時間間隔，其聲明如下：

	?
template<
????class?Rep,
????class?Period?=?std::ratio<1>
>?class?duration;


	?

	類成員類型描述：

				member type
			

				definition
			

				notes
		

				rep
			

				The first template parameter (Rep)
			

				Representation type used as the type for the internal?count?object.
		

				period
			

				The second template parameter (Period)
			

				The?ratio?type that represents a?period?in seconds.
		

	duration?由?Rep?類型的計次數(shù)和Period?類型的計次周期組成，其中計次周期是一個編譯期有理數(shù)常量，表示從一個計次到下一個的秒數(shù)。存儲于 duration 的數(shù)據(jù)僅有 Rep 類型的計次數(shù)。若 Rep 是浮點數(shù)，則 duration 能表示小數(shù)的計次數(shù)。Period 被包含為時長類型的一部分，且只在不同時長間轉(zhuǎn)換時使用。

	Rep?表示一種數(shù)值類型，用來表示 Period 的數(shù)量，比如 int float double (count of ticks)。

	Period?是 std::ratio 類型，用來表示【用秒表示的時間單位】比如 second milisecond (a tick period)。

	成員函數(shù)?count()?返回?Rep?類型的?Period?數(shù)量。

	常用的?duration?已經(jīng)定義好了，在?std::chrono?頭文件中，常用時長單位的代碼如下：

	?
///?nanoseconds
typedef?duration??nanoseconds;
///?microseconds
typedef?duration??microseconds;
///?milliseconds
typedef?duration??milliseconds;
///?seconds
typedef?duration???seconds;
///?minutes
typedef?duration>??minutes;
///?hours
typedef?duration>??hours;


	?

				類型
			

				定義
		

				std::nanoseconds
			

				duration
		

				std::microseconds
			

				duration
		

				std::milliseconds
			

				duration
		

				std::seconds
			

				duration
		

				std::minutes
			

				duration
		

				std::hours
			

				duration
		

	duration?類的?count()?成員函數(shù)返回時間間隔的具體數(shù)值。

	3.4.1，時間間隔轉(zhuǎn)換函數(shù) duration_cast

	因為有各種?duration?表示不同的時長單位，所以 chrono 庫提供了?duration_cast?函數(shù)來換?duration?類型，其聲明如下：

	?
template?
constexpr?ToDuration?duration_cast(const?duration&?d);


	?

	其定義比較復(fù)雜，但是我們?nèi)粘Ｊ褂每梢灾苯邮褂?auto?推導(dǎo)函數(shù)返回對象類型，示例代碼如下：

	?
#include?
#include?
#include?
#include?
?
void?f()
{
????std::sleep_for(std::seconds(1));
}
?
int?main()
{
????auto?t1?=?std::now();
????f();
????auto?t2?=?std::now();
????//?整數(shù)時長：要求 duration_cast
????auto?int_ms?=?std::duration_cast(t2?-?t1);
????//?小數(shù)時長：不要求 duration_cast
????std::duration?fp_ms?=?t2?-?t1;
????std::cout?<

	?

	3.5，時間點 time_point

	std::time_point?表示時間中的一個點（一個具體時間），如上個世紀(jì)80年代、你的生日、今天下午、火車出發(fā)時間等，只要它能用計算機(jī)時鐘表示。其包含了時鐘和時長兩個信息。它被實現(xiàn)成如同存儲一個?Duration?類型的自?Clock?的紀(jì)元起始開始的時間間隔的值。其聲明如下：

	?
template<
????class?Clock,
????class?Duration?=?typename?Clock::duration
>?class?time_point;


	?

	時鐘的?now()?函數(shù)返回的值就是一個時間點。time_point 中的 time_since_epoch() 返回從其時鐘起點開始的時長?？梢酝ㄟ^兩個時間點相減計算一個時間間隔，下面是代碼示例:

	?
#include???????/*?printf?*/
#include?
#include?
#include?

using?namespace?std;

void?time_point_test()
{
????auto?start?=?chrono::now();
????double?sum?=?0;
????for(int?i?=?0;?i?(time_diff);
????cout?<

	?

	3.5.1，時間點運算

	時間點有加法和減法操作，計算結(jié)果和常識一致：時間點 + 時長 = 時間點；時間點 - 時間點 = 時長。

	　　審核編輯：湯梓紅