time − Lire l’heure.

#include <time.h>

time_t time(time_t *t);

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’Ãpoque (Epoch en anglais).

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

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.

EFAULT

t pointe en dehors de l’espace d’adressage.

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.

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.

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

Christophe Blaess, 1997.