time() — 現在時刻の判別

フォーマット

#include <time.h>
time_t time(time_t *timeptr);

言語レベル

ANSI

スレッド・セーフ

はい

説明

time() 関数は、現在のカレンダー時間を秒単位で判別します。

注: カレンダー時間とは、エポックである UTC (1970 年 1 月 1 日 00:00:00) から数えた秒数です。

戻り値

time() 関数は、現在のカレンダー時間を戻します。また、戻り値は timeptr によって提供される場所にも保管されます。timeptr が NULL の場合には、戻り値は保管されません。カレンダー時間が使用できない場合には、値 (time_t)(-1) が戻されます。

例

この例では、時刻を取得して、それを ltime に割り当てます。その後 ctime() 関数は、秒数を現在の日時に変換します。この例では、その後で現在時刻を表示するメッセージを出力します。

#include <time.h>
#include <stdio.h>
 
int main(void)
{
   time_t ltime;
   if (time(&ltime) == -1)
   {
      printf("Calendar time not available.¥n");
      exit(1);
   }
   printf("The time is %s¥n", ctime(&ltime));
}
 
/******************  Output should be similar to:  ****************
 
The time is Mon Mar 22 19:01:41 2004
*/

time() — 現在時刻の判別

フォーマット

言語レベル

スレッド・セーフ

説明

戻り値

例

関連情報