C 庫函數(shù) – mktime()

C 庫函數(shù) - mktime()

C 標(biāo)準(zhǔn)庫 - <time.h>

描述

C 庫函數(shù) time_t mktime(struct tm *timeptr) 把 timeptr 所指向的結(jié)構(gòu)轉(zhuǎn)換為一個依據(jù)本地時區(qū)的 time_t 值。

聲明

下面是 mktime() 函數(shù)的聲明。

time_t mktime(struct tm *timeptr)

參數(shù)

• timeptr -- 這是指向表示日歷時間的 time_t 值的指針，該日歷時間被分解為以下各部分。下面是 timeptr 結(jié)構(gòu)的細(xì)節(jié)：

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 起的年數(shù)				*/
   int tm_wday;        /* 一周中的第幾天，范圍從 0 到 6		        */
   int tm_yday;        /* 一年中的第幾天，范圍從 0 到 365	                */
   int tm_isdst;       /* 夏令時						*/	
};

返回值

該函數(shù)返回一個 time_t 值，該值對應(yīng)于以參數(shù)傳遞的日歷時間。如果發(fā)生錯誤，則返回 -1 值。

實(shí)例

下面的實(shí)例演示了 mktime() 函數(shù)的用法。

#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 轉(zhuǎn)換時間。\n");
   }
   else
   {
      strftime(buffer, sizeof(buffer), "%c", &info );
      print(buffer);
   }

   return(0);
}

讓我們編譯并運(yùn)行上面的程序，這將產(chǎn)生以下結(jié)果：

Wed Jul 4 00:00:01 2001

C 標(biāo)準(zhǔn)庫 - <time.h>