C 庫 - mktime() 函式

---

---

C 庫的 mktime() 函式用於更改時間。它將時間結構轉換為日曆時間值。此函式接受日期和時間的各個組成部分，例如年、月、日、小時、分鐘和秒，並計算相應的 timestamps。

這裡，`time_t mktime(struct tm *timeptr)` 根據本地時區將 `timeptr` 指向的結構轉換為 `time_t` 值。

語法

以下是 C 庫 mktime() 函式的語法：

time_t mktime(struct tm *timeptr)

引數

此函式只接受一個引數：

• timeptr − 這是指向 `time_t` 值的指標，該值表示分解為其組成部分的日曆時間。
• 以下是 `timeptr` 結構的詳細資訊：

struct tm {
   int tm_sec;         /* seconds,  range 0 to 59          */
   int tm_min;         /* minutes, range 0 to 59           */
   int tm_hour;        /* hours, range 0 to 23             */
   int tm_mday;        /* day of the month, range 1 to 31  */
   int tm_mon;         /* month, range 0 to 11             */
   int tm_year;        /* The number of years since 1900   */
   int tm_wday;        /* day of the week, range 0 to 6    */
   int tm_yday;        /* day in the year, range 0 to 365  */
   int tm_isdst;       /* daylight saving time             */	
};

返回值

此函式返回一個與作為引數傳遞的日曆時間相對應的 `time_t` 值。如果發生錯誤，則返回 -1。

示例 1

以下是 C 庫程式的基本示例，用於演示 mktime() 函式。

#include <stdio.h>
#include <time.h>

int main () {
   int ret;
   struct tm info;
   char buffer[80];

   info.tm_year = 2001 - 1900;
   info.tm_mon = 7 - 1;
   info.tm_mday = 4;
   info.tm_hour = 0;
   info.tm_min = 0;
   info.tm_sec = 1;
   info.tm_isdst = -1;

   ret = mktime(&info);
   if( ret == -1 ) {
      printf("Error: unable to make time using mktime\n");
   } else {
      strftime(buffer, sizeof(buffer), "%c", &info );
      printf(buffer);
   }
 
   return(0);
} 

輸出

執行上述程式碼後，我們將得到以下結果：

Wed Jul 4 00:00:01 2001

示例 2

在此程式中，我們計算從現在開始的日期和時間（100 天和 30 小時），並列印相應的星期幾。

#include <stdio.h>
#include <time.h>

char *weekday[] = { "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday" };

int main(void) {
   time_t dt1, dt3;
   struct tm *t2;

   dt1 = time(NULL);
   t2 = localtime(&dt1);

   // Add 100 days and 30 hours
   t2->tm_mday += 100;
   t2->tm_hour += 30;

   dt3 = mktime(t2);

   printf("It will be a %s after 100 days and 30 hours from now.\n", weekday[t2->tm_wday]);
   return 0;
}

輸出

上述程式碼將產生以下結果：

It will be a Saturday after 100 days and 30 hours from now.