difftime, _difftime32, _difftime64

  • 项目

查找两次时间之间的差异。

语法

double difftime( time_t timeEnd, time_t timeStart );
double _difftime32( __time32_t timeEnd, __time32_t timeStart );
double _difftime64( __time64_t timeEnd, __time64_t timeStart );

参数

timeEnd
结束时间。

timeStart
开始时间。

返回值

difftime 返回从 timeStart 到 timeEnd 流逝的时间（以秒为单位）。 返回值为双精度浮点数字。 返回值可能为 0，表示错误。

备注

difftime 函数计算两个提供的时间值 timeStart 和 timeEnd 之间的差异。

提供的时间值必须在 time_t 范围内。 time_t 是 64 位值。 因此，范围的末尾已从 2038 年 1 月 18 日 23:59:59（UTC 时间）延至 3000 年 12 月 31 日 23:59:59。 time_t 的范围下限仍为 1970 年 1 月 1 日午夜。

difftime 是计算结果为 _difftime32 或 _difftime64 的内联函数，计算结果取决于是否定义了 _USE_32BIT_TIME_T。 _difftime32 和 _difftime64 可直接用于强制使用数据类型的特定大小。

这些函数验证其参数。 如果参数为零或负值，则调用无效参数处理程序，如参数验证中所述。 如果允许继续执行，则这些函数返回 0 并将 errno 设置为 EINVAL。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

要求

例程 必需的标头
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 );
}

Using random floating point numbers 1.04749e+038 2.01482e+038 1.72737e+038
Multiplying 2 floating point numbers 100 million times...
Program takes      3 seconds.

另请参阅

数学和浮点支持
工时管理
time、_time32、_time64