difftime, , _difftime32_difftime64

Определяет разницу между двумя значениями времени.

Синтаксис

double difftime( time_t timeEnd, time_t timeStart ); // See note in remarks section about linkage
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-разрядное значение. В связи с этим конец диапазона был увеличен с 23:59:59 18-го января 2038 года, UTC до 23:59:59 31-го декабря 3000 года. Нижняя граница диапазона time_t по-прежнему приходится на полночь 1-го января 1970 года.

difftime является встроенной функцией, которая вычисляет либо _difftime32, либо _difftime64 в зависимости от того, определен ли параметр _USE_32BIT_TIME_T. _difftime32 и _difftime64 можно использовать для принудительного применения определенного размера типа времени.

Эти функции проверяют свои параметры. Если любой из параметров равен нулю или отрицательным, вызывается обработчик недопустимых параметров, как описано в разделе проверки параметров. Если разрешается продолжать выполнение, эти функции возвращают -0 и задают для errno значение EINVAL.

По умолчанию глобальное состояние этой функции ограничивается приложением. Чтобы изменить это поведение, см . статью "Глобальное состояние" в CRT.

Замечание

Если вы используете пакет SDK для Windows версии 10.0.26100.6901 и Visual Studio 2026 или более поздней версии, difftime больше static inline не является (внутренняя компоновка). Вместо этого это inline (внешняя компоновка).
Чтобы вернуться к предыдущему поведению, #define _STATIC_INLINE_UCRT_FUNCTIONS=1 прежде чем включать любые заголовки CRT. По умолчанию параметр _STATIC_INLINE_UCRT_FUNCTIONS имеет значение 0.
Это изменение повышает соответствие UCRT стандарту C++ и улучшает совместимость с модулями C++.

Требования

Маршрут	Обязательный заголовок
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