Référence du fichier time.h


Description détaillée


Structures de données

struct  tm
 structure décrivant un temps calendrier Plus de détails...

Macros

#define NULL
 pointeur nul
#define CLOCKS_PER_SEC
 résolution du temps retourné par clock()

Définition de type

typedef __unsigned size_t
 taille des objets
typedef __arithmetic clock_t
 type des valeurs retournées par clock()
typedef __arithmetic time_t
 type des valeurs retournées par time()

Fonctions

clock_t clock (void)
 temps CPU consommé
double difftime (time_t t1, time_t t2)
 différence entre deux temps calendriers
time_t mktime (struct tm *timeptr)
 conversion entre les format du temps calendrier
time_t time (time_t *timer)
 temps actuel
char * asctime (const struct tm *timeptr)
 chaîne représentant le temps
char * ctime (const time_t *timer)
 chaîne représentant le temps
struct tmgmtime (const time_t *timer)
 décompose un time_t
struct tmlocaltime (const time_t *timer)
 décompose un time_t
size_t strftime (char *dst, size_t maxsize, const char *format, const struct tm *timeptr)
 formate un temps


Documentation des macros

#define CLOCKS_PER_SEC

Valeur dont le résultat de clock() augmente pour chaque seconde de temps CPU consommé par le processus.

#define NULL

Cette macro contient une constante de pointeur nul. Des valeurs populaires sont 0, 0L, (void*)0.

Voir stddef.h pour plus d'informations.


Documentation des définition de type

typedef __arithmetic clock_t

C'est un type arithmétique -- entier signé ou non ou flottant -- utilisé pour représenter le temps CPU consommé par le processus. Il est exprimé en unité de 1/CLOCKS_PER_SEC secondes.

typedef __unsigned size_t

Ce type entier non signé est capable de contenir la taille des objets.

Voir stddef.h pour plus d'informations.

typedef __arithmetic time_t

C'est un type arithmétique -- entier signé ou non ou flottant -- utilisé pour représenter les temps calendriers, date et heure du jour. Le codage utilisé n'est pas précisé.


Documentation des fonctions

char* asctime ( const struct tm timeptr  ) 

Retourne
Un pointeur vers une chaîne décrivant le temps calendrier décomposé donné par timeptr. La chaîne a le format "Sun Sep 16 01:03:52 1973\n".

Note:
Voir aussi ctime() et strftime(). Cette dernière fonction offre plus de contrôle sur le format de la chaîne

Ne pas oublier de copier la chaîne si elle doit être utilisée après un autre appel à asctime() ou à ctime().

clock_t clock ( void   ) 

Retourne
La meilleure approximation qu'a l'implémentation du temps CPU consommé par le processus depuis une origine liée uniquement au début de celui-ci. Pour avoir un temps en seconde, il faut diviser la valeur retournée par CLOCKS_PER_SEC.

(clock_t)-1 si aucune approximation n'est disponible ou si le résultat n'est pas représentable.

char* ctime ( const time_t timer  ) 

Retourne
Un pointeur vers une chaîne décrivant le temps calendrier donné par timer. La chaîne a le format "Sun Sep 16 01:03:52 1973\n".

Note:
Voir aussi asctime() et strftime(). Cette dernière fonction offre plus de contrôle sur le format de la chaîne

Ne pas oublier de copier la chaîne si elle doit être utilisée après un autre appel à asctime() ou à ctime().

double difftime ( time_t  t1,
time_t  t2 
)

Retourne
La différence en seconde entre deux temps calendrier (positif si t1 est postérieur à t2).

struct tm* gmtime ( const time_t timer  )  [read]

Retourne
Un pointeur vers un struct tm contenant la décomposition de timer en UTC (temps universel coordonné, qui a remplacé le temps GMT en 1972).

struct tm* localtime ( const time_t timer  )  [read]

Retourne
Un pointeur vers un struct tm contenant la décomposition de timer en temps local.

time_t mktime ( struct tm timeptr  ) 

Converti le temps calendrier décomposé en un time_t (utilisant le même codage que les valeurs retournée par time()). Les membres tm_wday et tm_yday sont ignorés, et les autres membres peuvent avoir des valeurs hors des l'intervalles donnés dans la description de struct tm. Si tm_isdst est positif, la conversion suppose que l'heure d'été était en vigueur, si le membre est nul, la conversion suppose que l'heure d'été n'était pas en vigueur, si le membre était négatif, la conversion essaie de déterminer si l'heure d'été était en vigueur ou non.

Après le retour de la fonction, tous les membres ont une valeur cohérente et dans l'intervalle spécifié dans la description de struct tm

Retourne
Le temps calendrier encodé comme par time().

(time_t) -1 si le temps calendrier ne peut pas être représenté.

size_t strftime ( char *  dst,
size_t  maxsize,
const char *  format,
const struct tm timeptr 
)

a l'abréviation du jour de la semaine A le nom complet du jour de la semaine b l'abréviation du nom du mois B le nom complet du mois c une représentation dépendante de la locale de la date et l'heure d le jour du mois en décimal H l'heure en décimal (24 heures) I l'heure en décimal (12 heures) j le jour de l'année en décimal m le mois en décimal M le nombre de minutes en décimal p indication dépendante de la locale indicant le matin/l'après midi S le nombre de seconde, en décimal U la semaine de l'année (le premier dimanche est le premier jour de la première semaine), en décimal w le jour de la semaine, en décimal, le dimanche étant 0 W la semaine de l'année (le premier lundi est le premier jour de la première semaine), en décimal x une représentation dependante de la locale de la date X une représentation de l'heure dépendante de la locale y l'année, sans sciècle, en décimal Y l'année, avec sciècle Z le nom ou l'abbréviation du fuseau horaire %% le caractère %

Retourne
Le nombre de caractères, y compris le caractère nul final, placés dans dst s'il faut moins de maxsize caractères pour formatter le temps d'après le format.

0 s'il aurait fallu plus de maxsize caractères pour formater le temps d'après format. Le contenu de dst est alors indéterminé.

Note:
Le comportement est indéfini si d'autres séquences de caractères commencent par %.

time_t time ( time_t timer  ) 

Si timer est non nul, la valeur retournée est assignée à *timer.

Retourne
Le temps calendrier au moment de l'appel.

(time_t) -1 si le temps n'est pas disponible.


Copyright © 2008 -- 2009 Jean-Marc Bourguet Accueil Pages sur le C