NUME

       time - obține timpul în secunde

BIBLIOTECA

       Biblioteca C standard (libc, -lc)

REZUMAT

       #include <time.h>

       time_t time(time_t *_Nullable tloc);

DESCRIERE

       time() returnează timpul ca număr de secunde de la Epoca, 1970-01-01 00:00:00:00 +0000 (UTC).

       Dacă tloc nu este NULL, valoarea de returnare este, de asemenea, stocată în memoria indicată de tloc.

VALOAREA RETURNATĂ

       În  caz  de succes, se returnează valoarea timpului în secunde de la Epoca (Epoch).  În caz de eroare, se
       returnează ((time_t) -1), iar errno este configurată pentru a indica eroarea.

ERORI

       EFAULT tloc indică în afara spațiului de adrese accesibil (dar consultați ERORI).

              Pe sistemele în care funcția de învăluire a bibliotecii C time() invocă o  implementare  furnizată
              de  vdso(7)  (astfel  încât să nu existe o captură în nucleu), o adresă nevalidă poate declanșa în
              schimb un semnal SIGSEGV.

STANDARDE

       SVr4, 4.3BSD, C99, POSIX.1-2001.  POSIX nu specifică nicio condiție de eroare.

NOTE

       POSIX.1 definește secunde de la Epoca folosind o formulă care aproximează numărul de  secunde  dintre  un
       moment  specificat  și Epoca.  Această formulă ia în considerare faptul că toți anii care sunt divizibili
       în mod egal cu 4 sunt ani bisecți, dar anii care sunt divizibili în mod egal cu 100 nu sunt  ani  bisecți
       decât  dacă  sunt,  de  asemenea,  divizibili  în mod egal cu 400, caz în care sunt ani bisecți.  Această
       valoare nu este identică cu numărul real de secunde dintre oră și Epoca, din cauza secundelor bisecte  și
       a  faptului că ceasurile de sistem nu trebuie să fie sincronizate cu o referință standard.  Intenția este
       ca interpretarea secundelor de la valorile Epocii să fie consecventă; a se vedea  POSIX.1-2008  Rationale
       A.4.15 pentru o justificare suplimentară.

       În Linux, un apel la time() cu tloc specificat ca fiind NULL nu poate eșua cu eroarea EOVERFLOW, chiar și
       în  cazul  ABI-urilor  în  care  time_t  este  un număr întreg pe 32 de biți cu semn și ceasul atinge sau
       depășește 2**31 secunde (2038-01-19 03:14:08 UTC, ignorând secundele bisecte).  (POSIX.1 permite, dar  nu
       necesită,  eroarea  EOVERFLOW  în  cazul  în  care secundele de la Epoca nu încap în time_t).  În schimb,
       comportamentul în Linux este nedefinit atunci când ora sistemului  este  în  afara  intervalului  time_t.
       Aplicațiile  destinate  să  ruleze  după 2038 ar trebui să utilizeze ABI-uri cu time_t mai largi de 32 de
       biți.

ERORI

       Returnările de eroare de la acest apel de sistem nu pot fi deosebite de rapoartele de succes care  indică
       faptul că timpul este cu câteva secunde înainte de Epoca, astfel încât funcția de învăluire a bibliotecii
       C nu configurează niciodată errno ca rezultat al acestui apel.

       Argumentul  tloc  este învechit și ar trebui să fie întotdeauna NULL în codul nou.  Atunci când tloc este
       NULL, apelul nu poate eșua.

   Diferențe între biblioteca C și nucleu
       Pe unele arhitecturi, o implementare a time() este furnizată în vdso(7).

CONSULTAȚI ȘI

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

TRADUCERE

       Traducerea   în   limba   română   a   acestui   manual   a   fost   creată   de   Remus-Gabriel    Chelu
       <remusgabriel.chelu@disroot.org>

       Această  traducere  este  documentație  gratuită;  citiți  Licența publică generală GNU Versiunea 3 sau o
       versiune  ulterioară  cu  privire  la  condiții  privind  drepturile  de  autor.   NU  se   asumă   Nicio
       RESPONSABILITATE.

       Dacă  găsiți  erori  în  traducerea  acestui manual, vă rugăm să trimiteți un e-mail la translation-team-
       ro@lists.sourceforge.net.

Pagini de manual de Linux 6.03                  29 decembrie 2022                                        time(2)