NOM

       time - Lire l'heure

SYNOPSIS

       #include <time.h>

       time_t time(time_t *t);

DESCRIPTION

       time()   renvoie  la date sous la forme du nombre de secondes depuis l'époque, 1er janvier
       1970 à 00:00:00 (UTC).

       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 le nombre de secondes écoulées depuis l'époque. 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.

CONFORMITÉ

       SVr4, BSD 4.3, C89, C99, POSIX.1-2001. POSIX ne précise pas de condition d'erreur.

NOTES

       POSIX.1 définit le nombre de secondes écoulées depuis l'époque grâce à une formule qui est
       une  approximation  du  nombre  de  secondes  entre  une date spécifiée et l'époque. Cette
       formule prend en compte le fait que les années divisibles par 4 sont bissextiles, sauf les
       années  qui  sont divisibles par 100 mais pas par 400. Cette valeur ne correspond donc pas
       toujours au véritable nombre de secondes écoulées depuis l'époque, à cause des secondes de
       rattrapage  et parce que les horloges système ne sont pas forcément synchronisées avec une
       référence  standard.  Cependant  elle  reste  cohérente  au  cours  du  temps.   Consultez
       l'explication A.4.15 de POSIX.1-2008 pour plus de détails.

VOIR AUSSI

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

COLOPHON

       Cette  page  fait partie de la publication 3.57 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Christophe    Blaess    <http://www.blaess.fr/christophe/>   (1996-2003),   Alain   Portal
       <http://manpagesfr.free.fr/>  (2003-2006).  Julien  Cristau  et  l'équipe  francophone  de
       traduction de Debian (2006-2009).

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».