time.h

time.hは、日付ひづけと時間じかんを操作そうさするための実装じっそうを提供ていきょうするC言語げんごの標準ひょうじゅんライブラリのヘッダファイルである。time.hでは、システム時刻じこくの取得しゅとく、日付ひづけ形式けいしきの変換へんかん、書式しょしき設定せっていされた文字もじ列れつとして出力しゅつりょくする機能きのうに対応たいおうしている。

機能きのうの概要がいよう

C言語げんごの日付ひづけと時間じかんの操作そうさに関かんする機能きのうは、time.hヘッダファイルで定義ていぎされている。

	識別子しきべつし	説明せつめい
時間じかん操作そうさ	difftime	2つのtime_t型かたの値ねの秒びょう単位たんいの差さを計算けいさんする。
	time	現在げんざいのシステム時刻じこくを秒びょう数すうを表あらわすtime_t型かたの値ねとして返かえす。エポックの値ねはオペレーティングシステムよって異ことなり、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型かたの値ねを協定きょうてい世界せかい時じとして表現ひょうげんされるカレンダー時間じかんに変換へんかんする。
	localtime	time_t型かたの値ねを現地げんち時間じかんとして表現ひょうげんされるカレンダー時間じかんに変換へんかんする。
	mktime	カレンダー時間じかんをtime_t型かたの値ねに変換へんかんする。
定数ていすう	CLOCKS_PER_SEC	1秒びょうあたりのCPU時間じかん。
	TIME_UTC	協定きょうてい世界せかい時じのためのベース時間じかん。
データ型がた	struct tm	カレンダー時間じかんの各かく要素ようそを表あらわす。
	time_t	算術さんじゅつ型がたとして定義ていぎされている時間じかん型がた。
	clock_t	CPU時間じかんを表あらわす。
	timespec	秒びょう単位たんいとナノ秒びょう単位たんいの時間じかんを表あらわす。

timespec型かたと関連かんれんする型かたは、当初とうしょは様々さまざまなベース時間じかんを提供ていきょうするためにMarkus Kuhnによって提案ていあんされたが、TIME_UTCのみが受うけ入いれられた。ただし、この機能きのうは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

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

• time_t
• UNIX時間じかん
• 2038年ねん問題もんだい