Langage de programmation - C - Référence des fonctions

DIFFTIME	Différence de temps
Langage C	time.h

Syntaxe

double difftime(time_h *end,time *start);

Paramètres

Nom	Description
start	Ce paramètre permet d'indiquer le temps à soustraire
end	Ce paramètre permet d'indiquer le temps d'origine

Description

Cette fonction permet de calculer la différence entre deux dates en secondes.

Algorithme

MODULE difftime(end, start)
   * Calculer la différence entre end et start
   difference ← end - start      * Différence en secondes (time_t est généralement un entier)

   * Retourner la différence sous forme de double
   RETOURNE difference

Remarques

Retour en secondes : La fonction renvoie la différence entre deux valeurs time_t en secondes. Le type time_t représente le nombre de secondes écoulées depuis le 1er janvier 1970 (l'époque Unix). La fonction retourne cette différence sous forme de double pour permettre une précision à la seconde près.
Précision de la fonction : Bien que la fonction difftime retourne un double, elle donne la différence en secondes, sans inclure des sous-secondes. Ainsi, la précision de la fonction dépend de la précision du type time_t, pouvant être en secondes, millisecondes ou plus, selon la plateforme, mais le résultat est toujours arrondi à la seconde.
Utilisation avec time_t : time_t est souvent utilisé pour entreposer des dates et heures dans les systèmes basés sur Unix. difftime est donc couramment utilisé pour calculer des durées entre deux dates ou événements. Par exemple, on peut utiliser cette fonction pour déterminer le temps écoulé entre deux événements dans un programme, comme la durée d'un téléchargement ou d'une exécution de tâche.
Comportement des dates antérieures : Si end est une valeur antérieure à start, la fonction retournera un résultat négatif. Cela peut être utile pour calculer des délais négatifs ou des différences de temps dans des cas où les événements sont chronométrés dans des ordres différents ou dans des périodes passées.
Compatibilité multiplateforme : La fonction difftime est largement utilisée pour des calculs de durée dans des applications multiplateformes. Comme time_t représente un nombre entier ou un type similaire selon l'architecture, la fonction difftime peut être utilisée de manière cohérente sur diverses plateformes sans se soucier de la représentation interne des valeurs de temps.
Limitations : Bien que la fonction difftime soit pratique, elle ne peut pas être utilisée pour des calculs précis dans des systèmes de temps très fins (comme les microsecondes ou les nanosecondes). Dans ces cas, des fonctions plus spécifiques ou des bibliothèques externes doivent être utilisées pour gérer des calculs de durées avec une plus grande précision.

Exemple

Voici quelques exemples typiques de l'utilisation de cette fonction :

Essayer maintenant !


				
#include <stdio.h>

#include <stdlib.h>

#include <time.h>

 
int main()

{

    time_t debut = 86400,fin;

    time(&fin);

    double diffTemps = difftime(fin,debut);

    printf("Nombre de secondes depuis 1 janvier 1970 : %.0f\n",diffTemps);

    return 0;

}

on obtiendra le résultat suivant si on est le 1er mai 2011 a 10:09 :

Nombre de secondes depuis 1 janvier 1970 : 1723858944

Voir également

Langage de programmation - C - Référence de procédures et fonctions - clock
Langage de programmation - C - Référence de procédures et fonctions - localtime
Langage de programmation - C - Référence de procédures et fonctions - mktime
Langage de programmation - C - Référence de procédures et fonctions - time
Langage de programmation - C++ - Référence de procédures et fonctions - difftime

Références

Langage C, Edition Micro-Application, Gehard Willms, 2001, ISBN: 2-7429-2008-0, page 731.
Borland C++ for Windows 4.0, Library Reference, Edition Borland, 1993, Part # BCP1240WW21772, page 66.

Dernière mise à jour : Mardi, le 28 juillet 2015

Section courante

A propos

Section administrative du site

DIFFTIME