C++ 日期 & 時間

C++ 標准庫沒有提供所謂的日期類型。C++ 繼承了 C 語言用於日期和時間操作的結構和函數。為了使用日期和時間相關的函數和結構，需要在 C++ 程序中引用 <ctime> 頭文件。

有四個與時間相關的類型：clock_t、time_t、size_t 和 tm。類型 clock_t、size_t 和 time_t 能夠把系統時間和日期表示為某種整數。

結構類型 tm 把日期和時間以 C 結構的形式保存，tm 結構的定義如下：

struct tm {
  int tm_sec;   // 秒，正常范圍從 0 到 59，但允許至 61
  int tm_min;   // 分，范圍從 0 到 59
  int tm_hour;  // 小時，范圍從 0 到 23
  int tm_mday;  // 一月中的第幾天，范圍從 1 到 31
  int tm_mon;   // 月，范圍從 0 到 11
  int tm_year;  // 自 1900 年起的年數
  int tm_wday;  // 一周中的第幾天，范圍從 0 到 6，從星期日算起
  int tm_yday;  // 一年中的第幾天，范圍從 0 到 365，從 1 月 1 日算起
  int tm_isdst; // 夏令時
}

下面是 C/C++ 中關於日期和時間的重要函數。所有這些函數都是 C/C++ 標准庫的組成部分，您可以在 C++ 標准庫中查看一下各個函數的細節。

序號函數 & 描述 1time_t time(time_t *time);
該函數返回系統的當前日歷時間，自 1970 年 1 月 1 日以來經過的秒數。如果系統沒有時間，則返回 .1。 2char *ctime(const time_t *time);
該返回一個表示當地時間的字符串指針，字符串形式 day month year hours:minutes:seconds year\n\0。 3struct tm *localtime(const time_t *time);
該函數返回一個指向表示本地時間的 tm 結構的指針。 4clock_t clock(void);
該函數返回程序執行起（一般為程序的開頭），處理器時鐘所使用的時間。如果時間不可用，則返回 .1。 5char * asctime ( const struct tm * time );
該函數返回一個指向字符串的指針，字符串包含了 time 所指向結構中存儲的信息，返回形式為：day month date hours:minutes:seconds year\n\0。 6struct tm *gmtime(const time_t *time);
該函數返回一個指向 time 的指針，time 為 tm 結構，用協調世界時（UTC）也被稱為格林尼治標准時間（GMT）表示。 7time_t mktime(struct tm *time);
該函數返回日歷時間，相當於 time 所指向結構中存儲的時間。 8double difftime ( time_t time2, time_t time1 );
該函數返回 time1 和 time2 之間相差的秒數。 9size_t strftime();
該函數可用於格式化日期和時間為指定的格式。

當前日期和時間

下面的實例獲取當前系統的日期和時間，包括本地時間和協調世界時（UTC）。

#include <iostream>
#include <ctime>

using namespace std;

int main( )
{
   // 基於當前系統的當前日期/時間
   time_t now = time(0);
   
   // 把 now 轉換為字符串形式
   char* dt = ctime(&now);

   cout << "本地日期和時間：" << dt << endl;

   // 把 now 轉換為 tm 結構
   tm *gmtm = gmtime(&now);
   dt = asctime(gmtm);
   cout << "UTC 日期和時間："<< dt << endl;
}

當上面的代碼被編譯和執行時，它會產生下列結果：

本地日期和時間：Sat Jan  8 20:07:41 2011

UTC 日期和時間：Sun Jan  9 03:07:41 2011

使用結構 tm 格式化時間

tm 結構在 C/C++ 中處理日期和時間相關的操作時，顯得尤為重要。tm 結構以 C 結構的形式保存日期和時間。大多數與時間相關的函數都使用了 tm 結構。下面的實例使用了 tm 結構和各種與日期和時間相關的函數。

在練習使用結構之前，需要對 C 結構有基本的了解，並懂得如何使用箭頭 -> 運算符來訪問結構成員。

#include <iostream>
#include <ctime>

using namespace std;

int main( )
{
   // 基於當前系統的當前日期/時間
   time_t now = time(0);

   cout << "Number of sec since January 1,1970:" << now << endl;

   tm *ltm = localtime(&now);

   // 輸出 tm 結構的各個組成部分
   cout << "Year: "<< 1900 + ltm->tm_year << endl;
   cout << "Month: "<< 1 + ltm->tm_mon<< endl;
   cout << "Day: "<<  ltm->tm_mday << endl;
   cout << "Time: "<< 1 + ltm->tm_hour << ":";
   cout << 1 + ltm->tm_min << ":";
   cout << 1 + ltm->tm_sec << endl;
}

當上面的代碼被編譯和執行時，它會產生下列結果：

Number of sec since January 1, 1970:1294548238
Year: 2011
Month: 1
Day: 8
Time: 22: 44:59