標準ライブラリヘッダー <time.h>

 

C

コンパイラサポート

言語

ヘッダー

型サポート

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

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

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

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

入出力サポート

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

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

標準ライブラリヘッダー

<assert.h> <complex.h> (C99) <ctype.h> <errno.h> <fenv.h> (C99) <float.h> <inttypes.h> (C99)     <iso646.h> (C95) <limits.h> <locale.h> <math.h>

<setjmp.h> <signal.h> <stdalign.h> (C11*) <stdarg.h> <stdatomic.h> (C11)     <stdbit.h> (C23) <stdbool.h> (C99*) <stdckdint.h> (C23) <stddef.h> <stdint.h> (C99) <stdio.h>

<stdlib.h> <stdmchar.h> (C29) <stdnoreturn.h> (C11*) <string.h> <tgmath.h> (C99) <threads.h> (C11) <time.h> <uchar.h> (C11) <wchar.h> (C95) <wctype.h> (C95)

 

このヘッダーは、日付と時刻ユーティリティライブラリの一部です。

関数

時刻操作
difftime	時刻間の差を計算する (関数)
time	エポックからの時間としてシステムの現在のカレンダー時間を返す (関数)
clock	プログラム開始からのプロセッサクロックの生時間を返す (関数)
timespec_get (C11)	与えられた時間基準に基づいて、カレンダー時間を秒とナノ秒で返す (関数)
timespec_getres (C23)	与えられた時間基準に基づいて、カレンダー時間の分解能を返す (関数)
書式変換
asctimeasctime_s (C23で非推奨)(C11)	tm オブジェクトをテキスト表現に変換する (関数)
ctimectime_s (C23で非推奨)(C11)	time_t オブジェクトをテキスト表現に変換する (関数)
strftime	tm オブジェクトをカスタムのテキスト表現に変換する (関数)
gmtimegmtime_rgmtime_s (C23)(C11)	エポックからの時間を、協定世界時 (UTC) で表されるカレンダー時間に変換する (関数)
localtimelocaltime_rlocaltime_s (C23)(C11)	エポックからの時間を、地方時で表されるカレンダー時間に変換する (関数)
mktime	カレンダー時間をエポックからの時間に変換する (関数)

定数

CLOCKS_PER_SEC

1秒あたりのプロセッサクロックティック数 (マクロ定数)

型

tm	カレンダー時間型 (構造体)
time_t	エポックからのカレンダー時刻型 (typedef)
clock_t	時代からのプロセッサ時間型 (typedef)
timespec (C11)	秒とナノ秒での時間 (構造体)

シノプシス

#define __STDC_VERSION_TIME_H__ 202311L
 
#define NULL           /* see description */
#define CLOCKS_PER_SEC /* see description */
#define TIME_UTC       /* see description */
 
typedef /* see description */ clock_t;
typedef /* see description */ size_t;
typedef /* see description */ time_t;
 
struct timespec { /* see description */ };
struct tm { /* see description */ };
 
clock_t clock(void);
double difftime(time_t time1, time_t time0);
time_t mktime(struct tm* timeptr);
time_t timegm(struct tm* timeptr);
time_t time(time_t* timer);
int timespec_get(struct timespec* ts, int base);
int timespec_getres(struct timespec* ts, int base);
[[deprecated]] char* asctime(const struct tm* timeptr);
[[deprecated]] char* ctime(const time_t* timer);
struct tm* gmtime(const time_t* timer);
struct tm* gmtime_r(const time_t* timer, struct tm* buf);
struct tm* localtime(const time_t* timer);
struct tm* localtime_r(const time_t* timer, struct tm* buf);
size_t strftime(char* restrict s, size_t maxsize, const char* restrict format,
const struct tm* restrict timeptr);

実装でサポートされている場合のみ

#define TIME_MONOTONIC /* see description */
#define TIME_ACTIVE    /* see description */

スレッドがサポートされ、実装でサポートされている場合のみ

#define TIME_THREAD_ACTIVE /* see description */

実装が __STDC_LIB_EXT1__ を定義し、さらにユーザーコードが <time.h> のインクルード前に __STDC_WANT_LIB_EXT1__ を定義した場合のみ

#ifdef __STDC_WANT_LIB_EXT1__
typedef /* see description */ errno_t;
typedef /* see description */ rsize_t;
 
errno_t asctime_s(char* s, rsize_t maxsize, const struct tm* timeptr);
errno_t ctime_s(char* s, rsize_t maxsize, const time_t* timer);
struct tm* gmtime_s(const time_t* restrict timer, struct tm* restrict result);
struct tm* localtime_s(const time_t* restrict timer, struct tm* restrict result);
#endif