Nom

time - Lire l'heure.

Résumé

#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

ctime (3), date (1), ftime (3), gettimeofday (2)

Traduction

Christophe Blaess, 1996-2003.