mktime() - C語言庫函數
C庫函數 time_t mktime(struct tm *timeptr) 指向的結構轉換成一個time_t值，根據本地時區。
聲明
以下是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值。
例子
下面的例子演示瞭如何使用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
"); } else { strftime(buffer, sizeof(buffer), "%c", &info ); print(buffer); } return(0); }
讓我們編譯和運行上面的程序，這將產生以下結果：
Wed Jul 4 00:00:01 2001