time

 

C

言語

ヘッダ

型サポート

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

可変長引数サポート

エラー処理

動的メモリ管理

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

文字列ライブラリ

アルゴリズム

数値演算

入出力サポート

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

アトミック操作(C11)

スレッドサポート(C11)

技術仕様書

 

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

関数

時間の操作

difftime

time

clock

timespec_get (C11)

フォーマット変換

asctimeasctime_s (C11)

ctimectime_s (C11)

strftime

wcsftime (C95)

gmtimegmtime_s (C11)

localtimelocaltime_s (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 オブジェクトにも格納します。

引数

arg

-

時刻を格納する time_t オブジェクトを指すポインタ、またはヌルポインタ

戻り値

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

ノート

time_t 内のカレンダー時刻のエンコーディングは未規定ですが、ほとんどのシステムでは POSIX の仕様に従い、エポックからの秒数を保持する整数型の値を返します。 time_t が32ビット符号付き整数の処理系 (多くの歴史的な処理系) は2038年問題があります。

例

Run this code

#include <stdio.h>#include <time.h>#include <stdint.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)

参考文献

• C11 standard (ISO/IEC 9899:2011):

• 7.27.2.4 The time function (p: 391)

• C99 standard (ISO/IEC 9899:1999):

• 7.23.2.4 The time function (p: 341)

• C89/C90 standard (ISO/IEC 9899:1990):

• 4.12.2.4 The time function

関連項目

localtimelocaltime_s (C11)	エポックからの経過時間を現地時間で表したカレンダー時刻に変換します (関数)
gmtimegmtime_s (C11)	エポックからの経過時間を協定世界時 (UTC) として表したカレンダー時刻に変換します (関数)
timespec_get (C11)	指定したタイムベースを基準とするカレンダー時刻を返します (関数)
time の C++リファレンス