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) が戻されます。

time() の使用例

この例では、時刻を取得して、それを 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
*/

関連情報

[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]