# C 庫函數 - localtime() ## 描述 C 庫函數 **struct tm *localtime(const time_t *timer)** 使用 timer 的值來填充 **tm** 結構。**timer** 的值被分解為 **tm** 結構，并用本地時區表示。 ## 聲明 下面是 localtime() 函數的聲明。 ``` struct tm *localtime(const time_t *timer) ``` ## 參數 * **timer** -- 這是指向表示日歷時間的 time_t 值的指針。 ## 返回值 該函數返回指向 **tm** 結構的指針，該結構帶有被填充的時間信息。下面是 tm 結構的細節： ``` 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; /* 夏令時 */ }; ``` ## 實例 下面的實例演示了 localtime() 函數的用法。 ``` #include <stdio.h> #include <time.h> int main () { time_t rawtime; struct tm *info; char buffer[80]; time( &rawtime ); info = localtime( &rawtime ); printf("當前的本地時間和日期：%s", asctime(info)); return(0); } ``` 讓我們編譯并運行上面的程序，這將產生以下結果： ``` 當前的本地時間和日期：Thu Aug 23 09:12:05 2012 ```