DIFFTIME |
Différence de temps |
---|---|
Langage C++ | ctime (time.h) |
Syntaxe
double difftime(time_h *h2,time *h1); |
Paramètres
Nom | Description |
---|---|
h1 | Ce paramètre permet d'indiquer le temps à soustraire |
h2 | Ce paramètre permet d'indiquer le temps d'origine |
Description
Cette fonction permet de calculer la différence entre deux dates en secondes.
Remarques
- La fonction difftime() renvoie la différence, en secondes, entre les paramètres h1 et h2. Autrement dit :
- Définition et utilité : La fonction difftime en C++ est utilisée pour calculer la différence entre deux valeurs de type time_t (représentant des instants dans le temps) et renvoyer cette différence sous la forme d'une valeur en secondes. Elle est définie dans la bibliothèque <ctime> et est couramment utilisée pour mesurer l'intervalle de temps entre deux moments donnés.
- Calcul de la différence en secondes : La fonction difftime renvoie un nombre de type double représentant la différence entre end et start en secondes. Si end est antérieur à start, la valeur renvoyée sera négative, indiquant une différence de temps dans le passé. Cela permet de calculer l'écart temporel entre deux événements avec une précision en secondes.
- Précision de la différence : La fonction difftime calcule la différence en secondes, mais il est important de noter que cette précision peut ne pas être suffisante pour des mesures de temps plus détaillées (par exemple, pour des intervalles en millisecondes ou microsecondes). Dans ces cas, des fonctions plus spécialisées ou des bibliothèques externes peuvent être nécessaires pour obtenir une précision plus fine.
- Propriétés de time_t&hnbsp;: Le paramètre passé à difftime est de type time_t, une structure représentant un nombre d'unités de temps depuis le 1er janvier 1970 (UTC). La représentation exacte de time_t peut varier selon les plateformes, mais elle est généralement un entier ou un entier long comptant le nombre de secondes écoulées depuis cette époque. La fonction difftime est donc utilisée pour effectuer des calculs de durée entre deux instants représentés sous cette forme.
- Comportement avec des valeurs négatives : Lorsque la première valeur (start) est plus grande que la deuxième (end), la fonction renvoie une valeur négative, ce qui indique que l'instant de début a lieu après l'instant de fin. Cette caractéristique est utile pour effectuer des calculs temporels sur des périodes passées ou pour détecter des erreurs dans l'ordre des événements temporels.
- Utilisation dans le calcul d'intervalles : La fonction difftime est très utilisée dans les applications où il est nécessaire de mesurer des intervalles de temps, comme pour déterminer la durée d'exécution d'un programme, la latence de communication entre serveurs, ou les délais entre deux événements dans un processus. Elle peut être combinée avec d'autres fonctions de gestion du temps (comme time, localtime, ou gmtime) pour effectuer des calculs complexes basés sur des horodatages.
h2 - h1 = resultat |
Exemples
Voici quelques exemples typiques de l'utilisation de cette fonction :

on obtiendra le résultat suivant si on est le 1er mai 2011 a 10:09 :
Nombre de secondes depuis 1 janvier 1970 : 1723858944Dans cet exemple, difftime est utilisée pour calculer la différence en secondes entre deux captures de temps. La fonction renverra le nombre de secondes écoulées entre les deux moments :
- #include <iostream>
- #include <ctime>
-
- int main() {
- time_t start = time(0); // Capture le temps actuel
- // Attendez un peu avant de capturer l'heure de fin
- time_t end = time(0); // Capture de nouveau le temps
- double diff = difftime(end, start); // Calcul de la différence
- std::cout << "Différence en secondes : " << diff << std::endl;
- return 0;
- }
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.