time_t

time_t型かたは、システム時刻じこくを表現ひょうげんあるいは保存ほぞんするために標準ひょうじゅんCライブラリが定義ていぎしているデータ型がたである。この値ねは標準ひょうじゅんのtime()ライブラリ関数かんすうによって得えられる。このデータ型がたは、標準ひょうじゅんの <time.h> ヘッダファイルでtypedefによって定義ていぎされている。ISO Cでは、time_tを数値すうち型がたと定義ていぎしているが、データ型がた・値ねの範囲はんい・周期しゅうきや、エンコーディング方法ほうほうは定義ていぎしていない。また、時刻じこくの値ねに対たいする算術さんじゅつ演算えんざんの動作どうさは定義ていぎしていない。

UNIXとPOSIX互換ごかんシステムでは、UNIX時間じかん（協定きょうてい世界せかい時じ (UTC) 1970年ねん1月がつ1日にち0時とき00分ぶん00秒びょうからの秒びょう数すう）を表あらわす符号ふごう付づけの整数せいすう（通常つうじょうは32または64ビット）でtime_t型かたを実装じっそうしている（閏うるう秒びょうは数かぞえない）。いくつかのシステムでは、負まけの時刻じこく値ちをサポートするが、サポートしないシステムもある。2038年ねん問題もんだいのために、32ビットのtime_tは非難ひなんされている。 そのため、最近さいきんのシステムには、time_tを64ビットの整数せいすう型がたとして定義ていぎしているものが多おおいが、古ふるいシステムではそうでないものもあるので注意ちゅういが必要ひつようである。

ISO Cでは、time()関数かんすうだけでなく、システム時刻じこくtime_tの値ねをカレンダー時刻じこくに変換へんかんする関数かんすうや、逆ぎゃくの変換へんかんを行おこなう関数かんすうなどを定義ていぎしている。

利用りよう例れい

以下いかのC言語げんごのコードは現在げんざい時刻じこくを取得しゅとくし、文字もじ列れつに整形せいけいし、標準ひょうじゅん出力しゅつりょくへ出力しゅつりょくする。

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

/*
* The result should look something like
* Fri 2008-08-22 15:21:59 WAST
*/

int main(void)
{
    time_t     now;
    struct tm  *ts;
    char       buf[80];

    // Get the current time
    now = time(NULL);

    // Format and print the time, "ddd yyyy-mm-dd hh:mm:ss zzz"
    ts = localtime(&now);
    strftime(buf, sizeof(buf), "%a %Y-%m-%d %H:%M:%S %Z", ts);
    printf("%s\n", buf);
    printf("%lld\n", (long long)now);

    return 0;
}

time_tパーティ

UNIXファンは、UNIX時間じかんの意味いみありげな値ねを祝賀しゅくがするためにtime_tパーティを行おこなってきた歴史れきしがある。これは、多おおくの暦こよみで年としが変かわるときに行おこなわれる新年しんねんパーティと良よく似にている。UNIX時間じかんの使用しようが広ひろがったことで、マイルストーンを祝いわうことが習慣しゅうかんとなった。通常つうじょうは端はし数すうのない10進数しんすうの時刻じこくの値ねが、time_t の値ねを10進数しんすうで眺ながめるUNIXのコンベンションで祝賀しゅくがされる。一部いちぶのグループは、2004年ねん1月がつ10日とおかの13:37:04 UTCに起おこった+2³⁰のような端はし数すうのない2進数しんすうも祝賀しゅくがしている。

これらの祝賀しゅくがイベントは、通常つうじょうは「UNIX epochからN秒びょう」と呼よばれるが、これは不正確ふせいかくである。上うえで述のべたとおり、UNIX時刻じこくの閏うるう秒びょうの扱あつかいのため、UNIX epochからの秒びょう数すうはUNIX時刻じこくの数かずよりもわずかに大おおきい。

2001年ねん9月9日にち 01:46:40 UTC、UNIX billennium（UNIX時刻じこくが1000000000）の祝賀しゅくがが行おこなわれた。

2005年ねん3月18日にち 01:58:31 UTC、UNIX時刻じこくが1111111111に到達とうたつした。

2009年ねん2月がつ13日にち 23:31:30 UTC、UNIX時刻じこくが1234567890に到達とうたつし、世界中せかいじゅうのさまざまなテクノロジーサブカルチャーの間あいだでパーティーやその他たの祝賀会しゅくがかいが開催かいさいされた。

2033年ねん5月18日にち 03:33:20 UTC、2回かい目めのUNIX billennium（UNIX時刻じこくが2000000000）の祝賀しゅくがが行おこなわれる予定よてい。

関連かんれん項目こうもく

• 標準ひょうじゅんCライブラリ
• リアルタイムクロック
• システム時刻じこく
• UNIX時間じかん
• 2038年ねん問題もんだい