TIME(3)

名称
time - 日時を取得

書式
#include <time.h> time_t time(time_t *tloc)

解説
time() 関数は、 1970 年 1 月 1 日 0 時 0 分 0 秒から数えた世界時を秒単位で返します。

時間数のコピーは、ポインタ tloc によって示される領域に保存されます。 tloc が NULL ポインタである場合は、値は保存されません。

操作が成功して終了すると、 time() 関数は時間の値を返します。それ以外の場合は、 ( (time_t) -1) という値が返され、エラーを示すグローバル変数 errno が設定されます。

エラー
errno には、次のエラーコードが設定されます。

[EFAULT]
    引数アドレスが無効なメモリを参照しました。

参照
gettimeofday(2), ctime(3)

歴史
time() 関数は、 AT&T UNIX に現れました。