difftime、_difftime32、_difftime64

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

2 つの時間の差を計算します。

double difftime( 
   time_t timer1,
   time_t timer0 
);
double _difftime32( 
      __time32_t timer1,
   __time32_t timer0 
);
double _difftime64( 
   __time64_t timer1,
   __time64_t timer0 
);

パラメータ

timer1
終了時刻。
timer0
開始時刻。

戻り値

difftime は、timer0 から timer1 までの経過時間 (秒) を返します。戻り値は、倍精度の浮動小数点数です。戻り値が 0 の場合はエラーを示します。

解説

difftime 関数は、指定された 2 つの時刻値 timer0 と timer1 の差を計算します。

指定する時刻値は、time_t の範囲内にあることが必要です。Visual C++ 2005 では、time_t は 64 ビット値です。したがって、この範囲の終わりは 2038 年 1 月 19 日 3 時 14 分 7 秒から 3000 年 12 月 31 日 23 時 59 分 59 秒に拡張されます。time_t の範囲の最小値は、1970 年 1 月 1 日午前 0 時のままです。

Visual C++ 2005 では、difftime は、_USE_32BIT_TIME_T が定義されているかどうかによって _difftime32 または _difftime64 になるインライン関数です。_difftime32 と _difftime64 は、特定のサイズの時間型の適用を強制する場合に使用します。

これらの関数では、パラメータの検証が行われます。いずれかのパラメータが 0 以下の場合、「パラメータの検証」に説明されているように、無効なパラメータハンドラが呼び出されます。実行の継続が許可された場合、これらの関数は 0 を返し、errno を EINVAL に設定します。

必要条件

ルーチン	必須ヘッダー
difftime	<time.h>
_difftime32	<time.h>
_difftime64	<time.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

// crt_difftime.c
// This program calculates the amount of time
// needed to do a floating-point multiply 500 million times.
//

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

int main( void )
{
   time_t   start, finish;
   long loop;
   double   result, elapsed_time;

   printf( "Multiplying 2 floating point numbers 500 million times...\n" );
   
   time( &start );
   for( loop = 0; loop < 500000000; loop++ )
      result = 3.63 * 5.27; 
   time( &finish );

   elapsed_time = difftime( finish, start );
   printf( "\nProgram takes %6.0f seconds.\n", elapsed_time );
}

Multiplying 2 floating point numbers 500 million times...

Program takes      5 seconds.