ctime (time.h) | Temps |
|---|---|
| Langage C++ | |
Description
Cette bibliothèque renferme les routines de traitement du temps. La bibliothèque ctime de fonctions standard définit plusieurs fonctions traitant de la date et de l'heure. Il définit également des fonctions gérant les informations géopolitiques associées à un programme. Les fonctions d'heure et de date nécessitent l'entête «ctime». Un programme C doit utiliser le fichier d'entête «time.h». Cet entête définit trois types liés au temps : clock_t, time_t et tm. Les types clock_t et time_t sont capables de représenter l'heure et la date du système sous la forme d'une sorte d'entier. C'est ce qu'on appelle l'heure du calendrier. Le type de structure tm contient la date et l'heure décomposées en ses éléments. La structure tm est définie comme indiqué ici :
- struct tm {
- int tm_sec; /* secondes, 0 à 61 */
- int tm_min; /* minutes, 0 à 59 */
- int tm_hour; /* heures, 0 à 23 */
- int tm_mday; /* jour du mois, 1 à 31 */
- int tm_mon; /* mois en commencant par janvier, 0 à 11 */
- int tm_year; /* année a partir de 1900 */
- int tm_wday; /* Jour de la semaine en commence par dimanche, 0 à 6 */
- int tm_yday; /* Jour l'année en commencant le 1er janvier, 0 à 365 */
- int tm_isdst /* Indicateur d'heure d'été */
- }
La valeur de tm_isdst sera positive si l'heure d'été est en vigueur, et vaudra zéro si elle n'est pas en vigueur et négative si aucune information n'est disponible. Ce format de l'heure et de la date est appelée heure décomposée. De plus, «ctime» définit la macro CLOCKS_PER_SEC, étant le nombre de tics d'horloge système par seconde. Les fonctions environnementales géopolitiques nécessitent l'entête «clocale». Un programme C doit utiliser le fichier d'entête «locale.h».
Liste des fonctions
| Nom | Prototype | Description |
|---|---|---|
| ASCTIME | char *asctime(struct tm *h) | Cette fonction permet de convertir de l'heure en chaîne de caractères. |
| CLOCK | clock_t clock(void) | Cette fonction indique le temps que l'ordinateur a utilisé depuis le début de son exécution. |
| CTIME | char *ctime(const time_h *h) | Cette fonction permet de convertir une heure sous forme de chaîne de caractères. |
| DIFFTIME | double difftime(time_h *h2,time *h1) | Cette fonction permet de calculer la différence entre deux dates en secondes. |
| GMTIME | struct tm *gmtime(const time_t *sec) | Cette fonction permet de convertir des secondes en date et heure. |
| LOCALTIME | struct tm *localtime(const time_t *sec) | Cette fonction permet de convertir des secondes en date et heure. |
| MKTIME | time_t *mktime(struct tm *ptrheure) | Cette fonction permet de convertir des heures local en heures normalisé. |
| STRFTIME | size_t strftime(char *s, size_t max, const char *format, const struct tm *tm); | Cette fonction permet d'effectuer la conversion des informations de date et de l'heure en une chaîne de caractères. |
| TIME | time_t time(time_t *ptrheure) | Cette fonction permet d'effectuer le calcul de l'heure courante en secondes. |
Liste des structures de données
| Nom | Description |
|---|---|
| TM | Cette structure de données permet d'indiquer la date et l'heure. |
Liste des types de données
| Nom | Description |
|---|---|
| clock_t | Ce type de données contient une représentation du nombre de tics d'horloge. Les tics d'horloge sont des unités de temps d'une longueur constante mais spécifique au système, comme celles renvoyées par l'horloge de fonction. |
| time_t | Ce type de données contient une représentation du temps, comme ceux retournés par la fonction time. |