Cette librairie fournit un ensemble de fonctions permettant la manipulation de dates, de temps et d'intervals. On peut classer les éléments de cette librairie en 3 catégories.
La librairie <time.h> met à votre disposition plusieurs types de données permettant la représentation d'informations temporelles sous différents formats. Voici la liste de ces types de données.
| Nom | Description | Depuis |
|---|---|---|
| clock_t | Représente un nombre de « tick » écoulé. | C89 |
| struct tm | Permet de manipuler un temps et ses constituantes (année, mois, jour, heure, minute, seconde, ...). | C89 |
| struct timespec | Représente un interval de temps exprimé en secondes et en nano-secondes. | C11 |
| time_t | Représente un « timestamp ». | C89 |
Les fonctions de manipulation d'information de temps : voici la liste de ces fonctions
| Nom | Description | Depuis |
|---|---|---|
| clock | Cette fonction retourne le nombre de « ticks » consommé par l'application en cours d'éxécution. | C89 |
| difftime | Cette fonction retourne, sous forme d'une valeur flottante en double précision, le nombre de secondes entre deux temps. | C89 |
| time | Permet d'obtenir le temps écoulé depuis le premier janvier 1970 à 00:00:00. | C89 |
| timespec_get | Initialise une structure timespec avec les informations du temps présent, en tenant compte d'une base de temps. |
C11 |
Les fonctions de conversion entre les différents formats de dates.
| Nom | Description | Depuis |
|---|---|---|
| asctime | Cette fonction permet de convertir une structure de type struct tm, contenant des informations de date et d'heure en une chaîne de caractères C au format « Www Mmm dd hh:mm:ss yyyy ». | C89 |
| ctime | Cette fonction permet de convertir un timestamp de type time_t, contenant des informations de date et d'heure en une chaîne de caractères C au format « Www Mmm dd hh:mm:ss yyyy ». | C89 |
| gmtime | Cette fonction transforme un timestamp (de type time_t) en une structure de type struct tm. | C89 |
| localtime | Cette fonction transforme un timestamp (de type time_t) en une structure de type struct tm. | C89 |
| mktime | Cette fonction transforme une structure struct tm, exprimée en temps local, en un timestamp de type time_t. | C89 |
| strftime | Cette fonction permet de convertir une structure de type struct tm, contenant des informations de date et d'heure en une chaîne de caractères C. | C89 |
Les éléments suivants complètent la documentation de l'entête <time.h>, notamment pour les ajouts ISO récents et les extensions POSIX.
| Nom | Type | Description |
|---|---|---|
__STDC_VERSION_TIME_H__ (C23) |
macro | Version de l'entête time.h. |
asctime_r (POSIX) |
fonction | Version réentrante POSIX de asctime. |
clock_getres (POSIX) |
fonction | Obtient la résolution d'une horloge POSIX. |
clock_gettime (POSIX) |
fonction | Lit la valeur courante d'une horloge POSIX. |
clock_nanosleep (POSIX) |
fonction | Suspend le thread courant selon une horloge POSIX. |
clock_settime (POSIX) |
fonction | Modifie la valeur d'une horloge POSIX configurable. |
clockid_t (POSIX) |
type | Type POSIX identifiant une horloge. |
ctime_r (POSIX) |
fonction | Version réentrante POSIX de ctime. |
getdate (POSIX) |
fonction | Convertit une chaîne en date selon des formats décrits par l'environnement POSIX. |
gmtime_r (POSIX) |
fonction | Version réentrante POSIX de gmtime. |
localtime_r (POSIX) |
fonction | Version réentrante POSIX de localtime. |
nanosleep (POSIX) |
fonction | Suspend le thread courant pendant une durée exprimée en secondes et nanosecondes. |
strftime_l (POSIX) |
fonction | Version localisée POSIX de strftime. |
strptime (POSIX) |
fonction | Analyse une chaîne de date selon un format. |
TIME_UTC (C11) |
macro | Base de temps utilisée avec timespec_get. |
timer_create (POSIX) |
fonction | Crée un timer POSIX. |
timer_delete (POSIX) |
fonction | Détruit un timer POSIX. |
timer_getoverrun (POSIX) |
fonction | Retourne le nombre d'expirations non livrées d'un timer POSIX. |
timer_gettime (POSIX) |
fonction | Lit l'état courant d'un timer POSIX. |
timer_settime (POSIX) |
fonction | Arme ou modifie un timer POSIX. |
timer_t (POSIX) |
type | Type POSIX identifiant un timer. |
timespec_getres (C23) |
fonction | Lit la résolution associée à une base de temps supportée par timespec_get. |
tzset (POSIX) |
fonction | Initialise les informations de fuseau horaire POSIX depuis l'environnement. |
Améliorations / Corrections
Vous avez des améliorations (ou des corrections) à proposer pour ce document : je vous remerçie par avance de m'en faire part, cela m'aide à améliorer le site.
Emplacement :
Description des améliorations :