Partilhar via

difftime, _difftime32, _difftime64

Encontra a diferença entre duas vezes.

Sintaxe

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 );

Parâmetros

timeEnd
Hora de encerramento.

timeStart
Hora de início.

Valor de retorno

difftime Devolve o tempo decorrido em segundos, de timeStart para timeEnd. O valor retornado é um número de ponto flutuante de precisão dupla. O valor de retorno pode ser 0, indicando um erro.

Observações

A difftime função calcula a diferença entre os dois valores timeStart de tempo fornecidos e timeEnd.

O valor de tempo fornecido deve caber dentro do intervalo de time_t. time_t é um valor de 64 bits. Assim, o fim do intervalo foi estendido de 23:59:59 18 de janeiro de 2038, UTC para 23:59:59, 31 de dezembro de 3000. A faixa inferior ainda é meia-noite, 1º de janeiro de time_t 1970.

difftime é uma função embutida que avalia para ou _difftime32_difftime64 dependendo se _USE_32BIT_TIME_T é definida. _difftime32 e _difftime64 podem ser usados diretamente para forçar o uso de um tamanho específico do tipo de tempo.

Estas funções validam os seus parâmetros. Se um dos parâmetros for zero ou negativo, o manipulador de parâmetros inválido será invocado, conforme descrito em Validação de parâmetros. Se a execução for permitida para continuar, essas funções retornarão 0 e serão definidas errno como EINVAL.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Observação

Se você usar o Windows SDK versão 10.0.26100.6901 e Visual Studio 2026 ou posterior juntos, difftime não é mais static inline (ligação interna). Em vez disso, é inline (ligação externa).
Para retornar ao comportamento anterior, #define _STATIC_INLINE_UCRT_FUNCTIONS=1 antes de incluir quaisquer cabeçalhos CRT. Por padrão, _STATIC_INLINE_UCRT_FUNCTIONS é definido como 0.
Essa alteração aumenta a conformidade do UCRT com o padrão C++ e melhora a compatibilidade com módulos C++.

Requerimentos

Rotina Cabeçalho obrigatório
difftime <time.h>
_difftime32 <time.h>
_difftime64 <time.h>

Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Example

// 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.

Consulte também

Suporte matemático e de ponto flutuante
Gestão do tempo
time, _time32, _time64

  • Last updated on