time(2) System Calls Manual time(2) NOM time - donner l'heure en secondes BIBLIOTHEQUE Bibliotheque C standard (libc, -lc) SYNOPSIS #include time_t time(time_t *_Nullable tloc); DESCRIPTION time() renvoie la date sous la forme du nombre de secondes depuis l'epoque POSIX (Epoch), 1er janvier 1970 a 00:00:00 (UTC). Si tloc n'est pas NULL, le code de retour est egalement stocke dans la structure de memoire vers laquelle il pointe. VALEUR RENVOYEE S'il reussit, l'appel time renvoie le nombre de secondes ecoulees depuis l'epoque POSIX. S'il echoue, la valeur ((time_t) -1) est renvoyee, et errno est defini pour preciser l'erreur. ERREURS EOVERFLOW La date ne peut pas etre representee comme une valeur time_t. Cela peut se produire si un executable avec un time_t 32 bits est execute sur un noyau 64 bits quand la date est 2038-01-19 03:14:08 UTC ou posterieure. Cependant, quand le temps systeme est en dehors de la plage de time_t dans d'autres situations, le comportement est indefini. EFAULT tloc pointe en dehors de l'espace d'adressage qui vous est accessible (mais voir BOGUES). Sur des systemes ou la fonction enveloppe time() de la bibliotheque C appelle une implementation fournie par vdso(7) (pour ne pas creer de faille dans le noyau), une adresse non valable peut alors provoquer un signal SIGSEGV. VERSIONS POSIX.1 definit le nombre de secondes ecoulees depuis l'epoque POSIX grace a une formule qui est une approximation du nombre de secondes entre une date specifiee et l'epoque POSIX. Cette formule prend en compte le fait que les annees divisibles par 4 sont bissextiles, sauf les annees qui sont divisibles par 100 mais pas par 400. Cette valeur ne correspond donc pas toujours au veritable nombre de secondes ecoulees entre la date et l'epoque, POSIX a cause des secondes intercalaires et parce que les horloges systeme ne sont pas forcement synchronisees avec une reference standard. Les systemes Linux suivent normalement l'exigence de POSIX que cette valeur ignore les secondes intercalaires, de sorte que les systemes conformes l'interpretent de facon coherente ; consultez l'explication A.4.16 de POSIX.1-2018. Les applications destinees a etre executees apres 2038 doivent utiliser des ABI avec time_t plus grande que 32 bits ; consultez time_t(3type). Differences entre bibliotheque C et noyau Sur certaines architectures, une implementation de time() est fournie dans le vdso(7). STANDARDS C11, POSIX.1-2008. HISTORIQUE SVr4, 4.3BSD, C89, POSIX.1-2001. BOGUES Les codes de retour d'erreur de cet appel systeme sont indistincts des retours lorsque l'appel reussit mais que le temps est de quelques secondes avant l'epoque POSIX, donc la fonction enveloppe de la bibliotheque C ne positionne jamais errno a la fin de cet appel. Le parametre tloc est obsolete et devrait toujours etre NULL dans du code nouveau. Quand tloc est NULL, l'appel ne peut pas echouer. VOIR AUSSI date(1), gettimeofday(2), ctime(3), ftime(3), time(7), vdso(7) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot et Jean-Philippe MENGUAL Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.12 23 juillet 2024 time(2)