man time (Appels systèmes) - Lire l'heure.

NOM

time - Lire l'heure.

SYNOPSIS

#include <time.h> time_t time(time_t *t);

DESCRIPTION

time renvoie l'heure actuelle sous forme du nombre de secondes écoulées depuis le 1er Janvier 1970 à 00h 00m 00s GMT, le début de l'Ère Unix.

Si t n'est pas NULL, la valeur renvoyée est également stockée dans la structure vers laquelle il pointe.

VALEUR RENVOYÉE

S'il réussit, l'appel time renvoie l'heure actuelle. S'il échoue, la valeur ((time_t)-1) est renvoyée, et errno contient le code d'erreur.

ERREURS

EFAULT
t pointe en dehors de l'espace d'adressage.

NOTES

POSIX.1 définit le nombre de secondes écoulées depuis le 1er Janvier 1970 à 0h grâce à une formule de conversion naïve ignorant les secondes supplémentaires de rattrapage périodique, et en considérant que toutes les années divisibles par 4 sont bissextiles. Cette valeur ne correspond donc pas toujours au véritable nombre de secondes écoulées, mais elle reste cohérente au cours du temps. Voir l'Annexe B 2.2.2 de POSIX.1 pour plus de détails.

CONFORMITÉ

SVr4, SVID, POSIX, X/OPEN, BSD 4.3

Sous BSD 4.3, cet appel est remplacé par gettimeofday(2). POSIX ne précise pas de condition d'erreur.

VOIR AUSSI

TRADUCTION

Christophe Blaess, 1996-2003.