# C 庫函數 - mktime() ## 描述 C 庫函數 **time_t mktime(struct tm *timeptr)** 把 **timeptr** 所指向的結構轉換為一個依據本地時區的 time_t 值。 ## 聲明 下面是 mktime() 函數的聲明。 ``` time_t mktime(struct tm *timeptr) ``` ## 參數 * **timeptr** -- 這是指向表示日歷時間的 time_t 值的指針，該日歷時間被分解為以下各部分。下面是 timeptr 結構的細節： ``` 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 到 11 */ int tm_year; /* 自 1900 起的年數 */ int tm_wday; /* 一周中的第幾天，范圍從 0 到 6 */ int tm_yday; /* 一年中的第幾天，范圍從 0 到 365 */ int tm_isdst; /* 夏令時 */ }; ``` ## 返回值 該函數返回一個 time_t 值，該值對應于以參數傳遞的日歷時間。如果發生錯誤，則返回 -1 值。 ## 實例 下面的實例演示了 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("錯誤：不能使用 mktime 轉換時間。\n"); } else { strftime(buffer, sizeof(buffer), "%c", &info ); print(buffer); } return(0); } ``` 讓我們編譯并運行上面的程序，這將產生以下結果： ``` Wed Jul 4 00:00:01 2001 ```