difftime

 

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> で定義
double difftime( time_t time_end, time_t time_beg );

2つのカレンダー時刻（time_t オブジェクト）の差（time_end - time_beg）を秒単位で計算します。time_end が time_beg より前の時点を参照する場合、結果は負になります。

パラメータ

time_beg, time_end

-

比較する時刻

戻り値

2つの時刻の差（秒単位）。

注記

POSIX システムでは、time_t は秒単位で測定され、difftime は算術的な減算と同等ですが、C および C++ では time_t に小数単位が許容されます。

例

以下のプログラムは、月の初めから経過した秒数を計算します。

このコードを実行

#include <stdio.h>
#include <time.h>
 
int main(void)
{
    time_t now = time(0);
 
    struct tm beg = *localtime(&now);
 
    // set beg to the beginning of the month
    beg.tm_hour = 0,
    beg.tm_min = 0,
    beg.tm_sec = 0,
    beg.tm_mday = 1;
 
    double seconds = difftime(now, mktime(&beg));
 
    printf("%.f seconds have passed since the beginning of the month.\n", seconds);
 
    return 0;
}

出力

1937968 seconds have passed since the beginning of the month.

参考文献

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

• 7.27.2.2 difftime 関数 (p: 285)

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

• 7.27.2.2 difftime 関数 (p: 390)

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

• 7.23.2.2 difftime 関数 (p: 338)

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

• 7.12.2.2 difftime 関数 (p: 171)

関連項目

C++ ドキュメント (difftime)