C-standard-library-c-function-mktime

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;        /*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
#include

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\n");
   } else {
      strftime(buffer, sizeof(buffer), "%c", &info );
      printf(buffer);
   }

   return(0);
}

次の結果を生成する上記のプログラムをコンパイルして実行しましょう-

Wed Jul 4 00:00:01 2001