C 标準庫 - <time.h>
描述
C 庫函數
struct tm *localtime(const time_t *timer)使用 timer 的值來填充
tm結構。
timer的值被分解為
結構，并用本地時區表示。
聲明
下面是 localtime() 函數的聲明。
struct tm *localtime(const time_t *timer)
參數
- -- 這是指向表示月曆時間的 time_t 值的指針。
傳回值
該函數傳回指向
結構的指針，該結構帶有被填充的時間資訊。下面是 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