time

現在時刻を取得します

【書式】
#include <time.h>
time_t time(time_t *timer);

【説明】
暦時刻を、timer が指す記憶場所に格納します。暦時刻は多くの処理系で、グリニッチ標準時(GMT)の1970年 1月 1日の00:00:00 から現在までの経過時間を秒単位で扱います。
time_t は time.h の中で宣言されていますが、一般に typedef long time_t; です。
timer に入る値と、関数の戻り値は同じ物です。ただし、timer に NULL を設定した場合には、戻り値に暦時間を返却するのみとなります。
返却データは localtime関数ctime関数を使って読めるようにするのが一般的です。

【引数】
time_t *timer : 経過時間の格納場所へのポインタ

【戻り値】
現在の暦時間(秒)。エラー時:-1 

【使用例】
#include <stdio.h>
#include <time.h>

int main(void)
{
   time_t timer;
   struct tm *t_st;

   /* 現在時刻の取得 */
   time(&timer);

   /* 現在時刻を文字列に変換して表示 */
   printf("現在時刻: %s\n", ctime(&timer));

   /* 現在時刻を構造体に変換 */
   t_st = localtime(&timer);
   printf("月: %d\n",t_st->tm_mon+1);   /* 月は+1 */
   printf("日: %d\n",t_st->tm_mday);
   printf("時: %d\n",t_st->tm_hour);
   printf("分: %d\n",t_st->tm_min);
   printf("秒: %d\n",t_st->tm_sec);

   return 0;
}
【実行結果例】
現在時刻: Wed Mar 06 00:35:26 2002

月: 3
日: 6
時: 0
分: 35
秒: 26

戻る


banner
初心者のためのポイント学習C言語」
Copyright(c) 2000-2004 TOMOJI All Rights Reserved