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.65 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> ».

Linux                                           9 septembre 2011                                         TIME(2)