difftime，_difftime32 _difftime64

發行項
03/15/2013

尋找兩個時間之間的差異。

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函式會計算兩個提供的時間值之間的差異timer0和timer1。

提供的時間值必須符合範圍內的time_t。 time_t是一個 64 位元值。因此，範圍的結尾 03: 14: 07 以後 2038 年 1 月 19 日從擴展為 23: 59: 59，3000 年 12 月 31。較低範圍的time_t仍是從 1970 年 1 月 1 日午夜。

difftime是內嵌函式會評估結果為_difftime32或_difftime64取決於是否_USE_32BIT_TIME_T定義。 _difftime32 和 _difftime64 可以用於直接用來強制在特定時間型別的大小。

這些函式會驗證它們的參數。如果是個參數為零或負值，不正確的參數處理常式會叫用，如所述參數驗證。如果執行，則允許繼續執行，這些函數會傳回 0，並設定errno到EINVAL。

需求

常式	所需的標頭
difftime	<time.h>
_difftime32	<time.h>
_difftime64	<time.h>

其他的相容性資訊，請參閱相容性在簡介中。

範例

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

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

double RangedRand( float range_min, float range_max)
{
   // Generate random numbers in the half-closed interval
   // [range_min, range_max). In other words,
   // range_min <= random number < range_max
   return ((double)rand() / (RAND_MAX + 1) * (range_max - range_min)
            + range_min);
}

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

   // Seed the random-number generator with the current time so that
   // the numbers will be different every time we run.
   srand( (unsigned)time( NULL ) );

   arNums[0] = RangedRand(1, FLT_MAX);
   arNums[1] = RangedRand(1, FLT_MAX);
   arNums[2] = RangedRand(1, FLT_MAX);
   printf( "Using floating point numbers %.5e %.5e %.5e\n", arNums[0], arNums[1], arNums[2] );

   printf( "Multiplying 2 numbers 100 million times...\n" );
   
   time( &start );
   for( loop = 0; loop < 100000000; loop++ )
      result = arNums[loop%3] * arNums[(loop+1)%3]; 
   time( &finish );

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