time_t型とは？C言語のUNIX時刻とエポック秒の基礎

2025年10月17日

C言語

C言語で扱う時刻の基本となるのがtime_tです。

多くのOSやライブラリでは、UNIX時刻と呼ばれる「1970-01-01 00:00:00」からの経過秒数として実装されています。

この記事では、time_tとは何か、どのような性質があり、どう使うのかを、初心者の方にも分かりやすいように丁寧に解説します。

目次 [ close ]

time_t型とは？C言語のUNIX時刻(エポック秒)の基本

time_tはUTCエポックからの経過秒

多くの環境では、time_tは「UTCにおけるエポックからの経過秒」を表す算術型です。

ここでいうエポックとは、UNIX系OSで採用される基準時刻のことです。

1秒ごとに1ずつ増える単純なカウンタと考えられ、ローカルタイムのタイムゾーンや夏時間の情報は含みません。

なお厳密にはC言語規格(ISO C)はエポックや単位を固定していませんが、POSIX系の実装(LinuxやmacOSなど)では、実質的に「UNIX時刻の秒」を意味します。

簡単な取得例と秒の加算

次の例では現在のUNIX時刻を取得し、24時間後の時刻を計算して比較します。

表示のためにinttypes.hのマクロを使い、time_tを安全に整数として出力しています。

C言語

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

// 説明: time_t の基本 - 現在のUNIX時刻を取得し、24時間後を計算して比較します。
// 注意: 出力は実行時の日時や環境に依存します。
int main(void) {
    // 現在のUNIX時刻(エポック秒)を取得
    time_t now = time(NULL);
    if (now == (time_t)-1) {
        // 取得に失敗した場合はエラーメッセージを表示して終了
        fprintf(stderr, "time関数で現在時刻の取得に失敗しました\n");
        return 1;
    }

    // 実装依存な性質を観察: サイズと符号
    printf("sizeof(time_t) = %zu bytes\n", sizeof(time_t));
    printf("time_t is %s\n", ((time_t)-1 < 0) ? "signed" : "unsigned");

    // エポック秒としての数値を表示
    printf("now (UNIX時刻) = %" PRIdMAX " 秒\n", (intmax_t)now);

    // 24時間(86400秒)後の時刻を計算
    const time_t one_day = (time_t)86400;    // 単位は秒
    time_t future = now + one_day;

    printf("future = now + 86400 -> %" PRIdMAX " 秒\n", (intmax_t)future);

    // 大小比較の例
    if (future > now) {
        puts("future は now より後の時刻です");
    } else {
        puts("future は now 以前の時刻です(オーバーフローの可能性)");
    }

    return 0;
}

実行結果

sizeof(time_t) = 8 bytes
time_t is signed
now (UNIX時刻) = 1734349876 秒
future = now + 86400 -> 1734436276 秒
future は now より後の時刻です

上のとおり、time_tにはタイムゾーンは含まれず、単に「UTCにおける秒数」を保持しています。

表示や整形は別の変換が必要になります。

エポックは1970-01-01 00:00:00

UNIX時刻のエポックは1970-01-01 00:00:00 UTCです。

time_tが0のときこの日時を表し、1ならその1秒後、-1なら1秒前(1969-12-31 23:59:59 UTC)を表します。

実装が符号付きであれば過去(1970年より前)も表現できますが、符号なし実装では負の値が使えないため過去を扱えない点に注意してください。

またPOSIXのUNIX時刻ではうるう秒を無視します。

そのため、UTCの厳密な秒数とは完全一致しない場合があります。

ローカル時刻ではなくUTC基準

time_tはローカルタイムを直接表しません。

夏時間やタイムゾーンは、表示や構造体への変換時に適用されます。

例えば「日本時間の今」を文字列にしたいときは、localtime等での変換が必要です。

反対に「UTCでの分解能が欲しい」場合はgmtime等を用います(これらの詳細は別記事で解説します)。

time_tの特徴

実装依存の型

time_tは「算術型」ですが、その具体的な型や範囲は実装に依存します。

多くは整数型(longやlong long相当)ですが、規格上は浮動小数点であっても合法です。

実務では整数型として実装されるのが一般的で、1単位がほぼ常に「1秒」です。

動作中のプロセスから観察するには、上のサンプルのようにsizeof(time_t)や、(time_t)-1 < 0の判定が有用です。

サイズと範囲は環境で異なる

32ビット環境では4バイト、64ビット環境では8バイトのtime_tが主流ですが、これは絶対ではありません。

とくに古いツールチェーンや組込み環境では差異が見られます。

代表的な例を挙げます。

あくまで「典型」であり、実機の値は必ず確認してください。

環境の例	sizeof(time_t)	典型的な符号	代表的な表現範囲(概算、UTC)
POSIX 32ビット(Linux i386などの旧環境)	4	符号付き	1901-12-13〜2038-01-19 03:14:07
POSIX 64ビット(Linux x86_64, AArch64, macOS)	8	符号付き	約±2.9e11年の広大な範囲
Windows(Visual C++ 2015以降の既定)	8	符号付き	約±2.9e11年の広大な範囲
旧Windowsや一部組込み	4	実装依存	2038年問題に注意