TIME(2)            Manuel du programmeur Linux            TIME(2)


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 sec­
       ondes é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 con­
       tient 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 divis­
       ibles 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, 1997.










Linux 2.0.30             11 Décembre 1997                       1