C fonctions date et heure - C date and time functions
| bibliothèque standard C |
|---|
| Thèmes généraux |
| En-têtes divers |
|
Les fonctions de date et d'heure C sont un groupe de fonctions de la bibliothèque standard du langage de programmation C mettant en œuvre des opérations de manipulation de date et d'heure. Ils prennent en charge l' acquisition de l' heure , la conversion entre les formats de date et la sortie formatée en chaînes.
Aperçu des fonctions
Les opérations de date et d'heure en C sont définies dans le time.h fichier d' en- tête ( ctimeheader en C++ ).
| Identifiant | La description | |
|---|---|---|
Manipulation du temps |
difftime
|
calcule la différence en secondes entre deux time_tvaleurs
|
time
|
renvoie l' heure actuelle du système sous forme de time_tvaleur, nombre de secondes, (qui est généralement le temps écoulé depuis une époque , généralement l' époque Unix ). La valeur de l'époque dépend du système d'exploitation ; 1900 et 1970 sont souvent utilisés. Voir RFC 868.
|
|
clock
|
renvoie un nombre de ticks de processeur associé au processus | |
timespec_get (C11)
|
renvoie une heure calendaire basée sur une base de temps | |
Conversions de format |
asctime
|
convertit un struct tmobjet en une représentation textuelle (obsolète)
|
ctime
|
convertit une time_tvaleur en une représentation textuelle
|
|
strftime
|
convertit un struct tmobjet en représentation textuelle personnalisée
|
|
wcsftime
|
convertit un struct tmobjet en représentation textuelle de chaîne large personnalisée
|
|
gmtime
|
convertit une time_tvaleur en temps calendaire exprimé en temps universel coordonné
|
|
localtime
|
convertit une time_tvaleur en heure calendaire exprimée en heure locale
|
|
mktime
|
convertit l'heure calendaire en une time_tvaleur.
|
|
| Constantes |
CLOCKS_PER_SEC
|
nombre de tops d'horloge du processeur par seconde |
TIME_UTC
|
base de temps UTC | |
| Les types |
struct tm
|
type de temps de calendrier décomposé : année, mois, jour, heure, minute, seconde |
time_t
|
type de temps arithmétique (généralement le temps depuis l'époque) | |
clock_t
|
type de temps d'exécution du processus | |
timespec
|
temps avec secondes et nanosecondes |
Les timespectypes et apparentés ont été initialement proposés par Markus Kuhn pour fournir une variété de bases de temps, mais seuls ont TIME_UTCété acceptés. Les fonctionnalités ont cependant été ajoutées au C++ en 2020 dans std::chrono.
Exemple
Le code source C suivant imprime l'heure actuelle dans le flux de sortie standard .
#include <time.h>
#include <stdlib.h>
#include <stdio.h>
int main(void)
{
time_t current_time;
char* c_time_string;
/* Obtain current time. */
current_time = time(NULL);
if (current_time == ((time_t)-1))
{
(void) fprintf(stderr, "Failure to obtain the current time.\n");
exit(EXIT_FAILURE);
}
/* Convert to local time format. */
c_time_string = ctime(¤t_time);
if (c_time_string == NULL)
{
(void) fprintf(stderr, "Failure to convert the current time.\n");
exit(EXIT_FAILURE);
}
/* Print to stdout. ctime() has already added a terminating newline character. */
(void) printf("Current time is %s", c_time_string);
exit(EXIT_SUCCESS);
}
La sortie est :
Current time is Thu Sep 15 21:18:23 2016