[C言語標準ライブラリ] time.hの使い方

time.hには、時間を操作するための型や関数が宣言および定義されています。
多くの関数は、現在の日付と時刻を表すカレンダータイムを扱います。
いくつかの関数は、特定のタイムゾーンで表現されるカレンダータイムであるローカルタイムや、ローカルタイムを決定するアルゴリズムの一時的な変更である夏時間を扱います。ローカルタイムゾーンと夏時間は実装で定義されます。

マクロ
1. CLOCKS_PER_SEC
2. NULL
型
時間を扱う関数
時間変換関数

マクロ

CLOCKS_PER_SEC

clock関数が返す値の、1秒あたりの数を定義するオブジェクト形式のマクロです。

NULL

NULLポインタ定数です。
stddef.h、locale.h、stdio.h、stdlib.h、string.h、time.h、wchar.hで定義されます。

型

clock_t

clock関数が返す時刻を表す型です。
算術型として定義されます。

size_t

sizeof演算子が生成する結果を表すための符号無し整数型です。
stddef.h、stdio.h、stdlib.h、string.h、time.h、wchar.hで定義されます。

struct tm

暦時刻を要素型の時刻として表す構造体型です。
tmは以下のメンバを含みます。

型	メンバ名	説明（値の範囲）
int	tm_sec	秒を表します。（0～60、0～61）※1
int	tm_min	分を表します。（0～59）
int	tm_hour	時を表します。（0～24）
int	tm_mday	日を表します。（1～31）
int	tm_mon	1月からの月数を表します。（0～11）
int	tm_year	1900年からの年数を表します。
int	tm_wday	日曜日からの日数を表します。（0～6）
int	tm_yday	1月1日からの日数を表します。（0～365）
int	tm_isdst	夏時間フラグです。※2

※1：C89の値の範囲は0～61です。2秒までのうるう秒が考慮されています。C99/C11の値の範囲は0～60です。正のうるう秒が考慮されています。

※2：夏時間を採用しているときに正、夏時間を採用していないときに0，その情報が得られないときに負となります。

time_t

暦時刻を表す型です。
算術型として定義されます。

時間を扱う関数

clock_t clock(void)

現在のプロセッサ時間を取得します。
プログラムの実行のみに関係する、経過したプロセッサ時間の値が返されます。
戻り値をCLOCKS_PRE_SECで割ることで、秒での経過時間を算出できます。
プロセッサ時間が使用できない、または値が表現できない場合は-1が返されます。

double difftime(time_t time1, time_t time0)

time1 – time0の2つのカレンダー時間の差を計算します。
秒で計った差が返されます。

time_t mktime(struct tm *timeptr)

展開時間をtime_t型に変換します。
引数timeptrが指すオブジェクトの局所時間で表した展開時間が、time関数が返す値と同じ形式で返されます。
構造体メンバのtm_wdayとtm_ydayは無視されます。
正常に終了した場合は、構造体メンバのtm_wdayおよびtm_ydayには、適切な値が格納されます。
tm_mdayの終端値はtm_monおよびtm_yearが決定されるまで設定されません。
指定されたカレンダー時間をtime_t型としてエンコードした値が返されます。
カレンダー時間が表現不可能な場合は、-1が返されます。

time_t time(time_t *timer)

現在のカレンダー時間を取得します。
カレンダー時間が使用できない場合は、-1が返されます。
timerがNULLポインタでなければ、ポインタが指すオブジェクトにも戻り値が格納されます。

時間変換関数

char asctime(const struct tm timeptr)

struct tm型のオブジェクトを以下の形式の文字列に変換します。

Sun Sep 16 01:03:52 1973\n\0

この文字列へのポインタが返されます。

char ctime(const time_t timer)

time_t型のオブジェクトを文字列に変換します。
asctime(localtime(timer))と同等です。
asctime関数が返す値が返されます。

struct tm gmtime(const time_t timer)

time_t型のオブジェクトをUTC(Coordinated Universal Time:協定世界時)としてstruct tmに変換します。
渡されたオブジェクトへのポインタが返されます。
UTC が使用不能な場合はNULLポインタが返されます。

struct tm localtime(const time_t timer)

time_t型のオブジェクトを現在の時間帯でstruct tmに変換します。
オブジェクトへのポインタが返されます。

size_t strftime(char s, size_t maxsize, const char format, const struct tm *timeptr)

引数sが指す配列にformatに制御される文字列を格納します。
書式はマルチバイト文字の連なりで、初期シフト状態に始まり初期シフト状態で終わる必要があります。
format文字列は0以上の変換指定子とマルチバイト文字から成っています。
変換指定子は1文字の%と、その後の変換動作を決定する一文字から成っています。
終端のNULL文字を含む全てのマルチバイト文字は、変更を加えられずに配列にコピーされます。
コピーが重複するオブジェクト間で発生した場合の動作は未定義です。
maxsize以下の文字が配列に格納されます。
各変換指定子は下表の文字列によって置き換えられます。
適切な文字列は、LC_TIME分野のロケールおよびtimeptrが指すオブジェクトによって決定されます。

変換指定子	説明
%a	ロケールでの曜日の略名で置換されます。
%A	ロケールでの曜日の名前で置換されます。
%b	ロケールでの月の略名で置換されます。
%B	ロケールでの月の名前で置換されます。
%c	ロケールでの適切な日付と時刻で置換されます。
%d	月の中の日が10進数で置換されます。(01-31)
%H	24時間時計での時間が10進数で置換されます。(00-23)
%I	12時間時計での時間が10進数で置換されます。(01-12)
%j	年の中の日が10進数で置換されます。(001-366)
%m	月が10進数で置換されます。(01-12)
%M	分が10進数で置換されます。(00-59)
%p	ロケールでの、12時間時計でいう午前・午後に相当する文字列で置換されます。
%S	秒が10進数で置換されます。(00-61)
%U	年の始まりから経過した週の数（最初の日曜を最初の週の最初の日として）が10進数で置換されます。(00-53)
%w	日曜を0として、曜日が10進数で置換されます。(0-6)
%W	年の始まりから経過した週の数（最初の月曜を最初の週の最初の日として）が10進数で置換されます。(00-53)
%x	ロケールでの適切な日付表現で置換されます。
%X	ロケールでの適切な時刻表現で置換されます。
%y	世紀を除いた年が10進数で置換されます。(00-99)
%Y	世紀を含んだ年が10進数で置換されます。
%z	時間帯の略名か、時間帯が決定されない場合は空文字列で置換されます。
%%	%で置換されます。