difftime、_difftime32、_difftime64

發行項
06/09/2015

尋找兩次間的差異。

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 位元的值。因此，此範圍結尾從 2038 年1 月 19 日 03:14:07 擴充至 3000 年 12 月 31 日 23:59:59。 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 );
}