tm

 

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> で定義
struct tm;

カレンダーの日付と時刻を構成要素に分解して保持する構造体。

メンバオブジェクト

int tm_sec	分後の秒数 – [​0​, 61](C99まで)[​0​, 60](C99以降) (public メンバーオブジェクト)
int tm_min	時間ごとの分数 – [​0​, 59] (public メンバーオブジェクト)
int tm_hour	深夜からの時間数 – [​0​, 23] (public メンバーオブジェクト)
int tm_mday	月の日数 – [1, 31] (public メンバーオブジェクト)
int tm_mon	1月からの月数 – [​0​, 11] (public メンバーオブジェクト)
int tm_year	1900年からの年数 (public メンバーオブジェクト)
int tm_wday	日曜日からの日数 – [​0​, 6] (public メンバーオブジェクト)
int tm_yday	1月1日からの日数 – [​0​, 365] (public メンバーオブジェクト)
int tm_isdst	夏時間フラグ。DSTが有効な場合は正の値、無効な場合はゼロ、情報が利用できない場合は負の値。 (public メンバーオブジェクト)

注記

規格では、上記のメンバのみが存在することが規定されています。順序は規定されていません。実装では通常、この構造体にさらにデータメンバが追加されます。

例

このコードを実行

#include <stdio.h>
#include <time.h>
 
int main(void)
{
    struct tm start = {.tm_year = 2022 - 1900, .tm_mday = 1};
    mktime(&start);
    printf("%s", asctime(&start)); // note implicit trailing '\n'
}

出力

Sat Jan  1 00:00:00 2022

参考文献

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

• 7.27.1/3 時間の構成要素 (p: TBD)

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

• 7.27.1/3 時間の構成要素 (p: 284)

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

• 7.27.1/3 時間の構成要素 (p: 388)

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

• 7.23.1/3 時間の構成要素 (p: 338)

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

• 4.12.1 時間の構成要素

関連項目

localtimelocaltime_rlocaltime_s (C23)(C11)	エポックからの時間を、地方時で表されるカレンダー時間に変換する (関数)
gmtimegmtime_rgmtime_s (C23)(C11)	エポックからの時間を、協定世界時 (UTC) で表されるカレンダー時間に変換する (関数)
C++ ドキュメント (tm)