time.hとは？わかりやすく解説

time.hは、日付と時間を操作するための実装を提供するC言語の標準ライブラリのヘッダファイルである。time.hでは、システム時刻の取得、日付形式の変換、書式設定された文字列として出力する機能に対応している^[1]。

機能の概要

C言語の日付と時間の操作に関する機能は、time.hヘッダファイル^{[注釈 1]}で定義されている。

	識別子	説明
時間操作	`difftime`	2つの`time_t`型の値の秒単位の差を計算する。
	`time`	現在のシステム時刻を秒数を表す`time_t`型の値として返す^{[注釈 2]}。エポックの値はオペレーティングシステムよって異なり、1900年と1970年がよく使われる。RFC 868を参照。
	`clock`	プロセスに関連付けられたCPU時間を返す。
	`timespec_get`（C11）	指定されたベース時間に基づいたカレンダー時間を返す。
形式変換	`asctime`	`struct tm`型のオブジェクトを文字列表現に変換する（非推奨）。
	`ctime`	`time_t`型の値を文字列表現に変換する。
	`strftime`	`struct tm`型のオブジェクトを指定された書式設定に基づいた文字列表現に変換する。
	`strptime`	`struct tm`時間情報を含んだ文字列を`struct tm`型に変換する。
	`wcsftime`	`struct tm`型のオブジェクトを指定された書式設定に基づいたワイド文字列表現に変換する。
	`gmtime`	`time_t`型の値を協定世界時として表現されるカレンダー時間に変換する^[2]。
	`localtime`	`time_t`型の値を現地時間として表現されるカレンダー時間に変換する。
	`mktime`	カレンダー時間を`time_t`型の値に変換する。
定数	`CLOCKS_PER_SEC`	1秒あたりのCPU時間。
定数	`TIME_UTC`	協定世界時のためのベース時間。
データ型	`struct tm`	カレンダー時間の各要素を表す。
	`time_t`	算術型として定義されている時間型^{[注釈 3]}。
	`clock_t`	CPU時間を表す。
	`timespec`	秒単位とナノ秒単位の時間を表す。

timespec型と関連する型は、当初は様々なベース時間を提供するためにMarkus Kuhnによって提案されたが、TIME_UTCのみが受け入れられた^[3]。ただし、この機能は2020年にC++のstd::chronoに追加された。

例

以下のC言語のコードは、現在時間を標準出力に出力する。

#include <time.h>
#include <stdlib.h>
#include <stdio.h>

int main(void)
{
    time_t current_time;
    char* c_time_string;

    /* Obtain current time. */
    current_time = time(NULL);

    if (current_time == ((time_t)-1))
    {
        (void) fprintf(stderr, "Failure to obtain the current time.\n");
        exit(EXIT_FAILURE);
    }

    /* Convert to local time format. */
    c_time_string = ctime(&current_time);

    if (c_time_string == NULL)
    {
        (void) fprintf(stderr, "Failure to convert the current time.\n");
        exit(EXIT_FAILURE);
    }

    /* Print to stdout. ctime() has already added a terminating newline character. */
    (void) printf("Current time is %s", c_time_string);
    exit(EXIT_SUCCESS);
}

出力:

Current time is Thu Sep 15 21:18:23 2016

脚注

注釈

^ C++ではctimeヘッダ。
^ これは通常はエポック（英語版）からの経過時間であり、一般的にはUNIXエポックである。
^ 通常はUNIXエポックからの経過時間。

出典

^ ISO/IEC 9899:1999 specification. p. 351, § 7.32.2
^ open-std.org - Committee Draft -- May 6, 2005 page 355
^ Markus Kuhn. “Modernized API for ISO C”. cl.cam.ac.uk. 2023年11月30日閲覧。

外部リンク

[2] C++ではctimeヘッダ。

[3] これは通常はエポック（英語版）からの経過時間であり、一般的にはUNIXエポックである。

[5] 通常はUNIXエポックからの経過時間。

[1] ISO/IEC 9899:1999 specification. p. 351, § 7.32.2

[4] -std.org - Committee Draft -- May 6, 2005 page 355

[6] Markus Kuhn. “Modernized API for ISO C”. cl.cam.ac.uk. 2023年11月30日閲覧。

[1]

[注釈 1]

[注釈 2]

[2]

[注釈 3]

[3]

表話編歴 C言語
K&R ANSI C C89 C90 C99 C11 C17（英語版） C2x（英語版） Embedded C（英語版） MISRA C
Cの機能	関数ヘッダファイル演算子文字列（英語版）文法（英語版）プリプロセッサ（英語版）データ型（英語版）キーワードフリースタンディング環境
標準Cライブラリの関数	ctype.h（英語版） stdio.h math.h（英語版） stdlib.h（英語版） string.h（英語版） time.h stdarg.h（英語版） POSIXライブラリ（英語版）
標準Cライブラリ	Bionic（英語版） libhybris（英語版） dietlibc EGLIBC glibc klibc（英語版）マイクロソフトランタイムライブラリ（英語版） musl Newlib uClibc BSD libc
コンパイラ	ACK（英語版） BDS-C Clang C++ Builder gcc Intel C++ Compiler LCC（英語版） LSI C-86 Pelles C（英語版） PCC TCC Turbo C Microsoft Visual C++ Watcom C/C++（英語版）
統合開発環境	Anjuta Code::Blocks CodeLite Eclipse Geany Microsoft Visual Studio NetBeans CLion
派生言語	C++ Cg Cω D言語 Objective-C Alef（英語版） Limbo Go Vala SystemC Unified Parallel C
関連項目	IOCCC
カテゴリ

標準Cライブラリ（libc）
一般
データ型（英語版）文字の分類（英語版）文字列（英語版）数学（英語版）標準入出力日付と時間ローカライゼーション（英語版）メモリ確保（英語版）プロセス管理（英語版）シグナル（英語版）代替トークン
その他
<assert.h（英語版）> <errno.h（英語版）> <setjmp.h（英語版）> <stdarg.h（英語版）>
表話編歴

time.hとは？ わかりやすく解説

time.h

機能の概要

例

脚注

注釈

出典

関連項目

外部リンク

急上昇のことば

「time.h」の関連用語

time.hとは？わかりやすく解説