time

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

日付と時刻のユーティリティ

関数

時刻操作

difftime

time

clock

timespec_get (C11)

timespec_getres (C23)

書式変換

asctimeasctime_s (C23で非推奨)(C11)

ctimectime_s (C23で非推奨)(C11)

strftime

wcsftime (C95)

gmtimegmtime_rgmtime_s (C23)(C11)

localtimelocaltime_rlocaltime_s (C23)(C11)

mktime

定数

CLOCKS_PER_SEC

型

tm

time_t

clock_t

timespec (C11)

 

ヘッダー <time.h> で定義
time_t time( time_t* arg );

time_t オブジェクトとしてエンコードされた現在のカレンダ時刻を返します。また、arg がヌルポインタでない限り、arg が指す time_t オブジェクトにも格納します。

Parameters

arg

-

時刻が格納される time_t オブジェクトへのポインタ、またはヌルポインタ。

Return value

成功時は time_t オブジェクトとしてエンコードされた現在のカレンダ時刻、エラー時は (time_t)(-1)。 arg がヌルポインタでない場合、戻り値は arg が指すオブジェクトにも格納されます。

Notes

time_t におけるカレンダ時刻のエンコーディングは未指定ですが、ほとんどのシステムは POSIX 仕様に準拠しており、エポックからの秒数を保持する整数型を返します。 time_t が 32 ビット符号付き整数である実装（多くの歴史的な実装）は、2038 年に問題が発生します。

Example

このコードを実行

#include <stdint.h>
#include <stdio.h>
#include <time.h>
 
int main(void)
{
    time_t result = time(NULL);
    if (result != (time_t)(-1))
        printf("The current time is %s(%jd seconds since the Epoch)\n",
               asctime(gmtime(&result)), (intmax_t)result);
}

実行結果の例

The current time is Fri Apr 24 15:05:25 2015
(1429887925 seconds since the Epoch)

References

• C23標準 (ISO/IEC 9899:2024)

• 7.27.2.4 The time function (p: TBD)

• C17標準 (ISO/IEC 9899:2018)

• 7.27.2.4 The time function (p: 286)

• C11標準 (ISO/IEC 9899:2011)

• 7.27.2.4 The time function (p: 391)

• C99標準 (ISO/IEC 9899:1999)

• 7.23.2.4 The time function (p: 341)

• C89/C90標準 (ISO/IEC 9899:1990)

• 4.12.2.4 The time function

See also

localtimelocaltime_rlocaltime_s (C23)(C11)	エポックからの時間を、地方時で表されるカレンダー時間に変換する (関数)
gmtimegmtime_rgmtime_s (C23)(C11)	エポックからの時間を、協定世界時 (UTC) で表されるカレンダー時間に変換する (関数)
timespec_get (C11)	与えられた時間基準に基づいて、カレンダー時間を秒とナノ秒で返す (関数)
C++ ドキュメント （time について）