Fonctions du
système (section 2) time
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'Epoque (Epoch en anglais).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.3Sous 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, 1997.