TIME(3)

名称
time - 日時を取得

ライブラリ
libc

書式
<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 で登場しました。