NAVN

C-standardbibliotek (libc, -lc)

#include <time.h>

time_t time(time_t *_Nullable tloc);

time() returnerer tiden som antallet af sekunder siden Epoch'en, 1970-01-01 00:00:00 +0000 (UTC).

Hvis tloc er ikke-NULL så lagres returværdien også i hukommelsen peget mod af tloc.

Ved succes returneres værdien af tid i sekunder siden Epoch'en. Ved fejl returneres ((time_t) -1) og errno angives for at indikere fejlen.

EOVERFLOW

Tiden kan ikke repræsenteres som en time_t-værdi. Dette kan ske hvis en kørbar fil med 32-bit time_t afvikles på en 64-bit kerne, når tiden er 2038-01-19 03:14:08 UTC eller senere. Når systemtiden er uden for time_t-intervallet i andre situationer, så er denne opførelse ej defineret.

EFAULT

tloc peger uden for dit tilgængelige adresserum (men se BUGS).

På systemer hvor C-bibliotekets time()-omslagsfunktion igangsætter en implementering tilbudt af vdso(7) (så der ikke er en fælde ind i kernen), kan en ugyldig adresse i stedet for udløse et SIGSEGV-signal.

POSIX.1 definerer sekunder siden Epoch'en via en formel, der tilnærmer antallet af sekunder mellem et angivet tidspunkt og Epoch'en. Denne formel tager højde for det faktum at alle år der er delelige med 4 er skudår, men år der er delelige med 100 er ikke skudår medmindre de også er delelige med 400, i hvilket tilfælde de er skudår. Denne værdi er ikke den samme som det faktiske antal sekunder mellem tidspunktet og Epoch'en, på grund af skudsekunder og på grund af at systemuret ikke er krævet at være synkroniseret med en standardreference. Linuxsystemer følger normalt POSIX-kravet at denne værdi ignoerer skudsekunder, så at overholdende systemer fortolker det konsistent; se POSIX.1-2018 Rationale A.4.16.

Programmer lavet for at blive afviklet efter 2038 bør bruge ABI'er med time_t bredere end 32 bit; se time_t(3type).

C11, POSIX.1-2024.

SVr4, 4.3BSD, C89, POSIX.1-2001, V7.

Fejl returneret fra dette systemkald kan ikke skelnes fra succesfulde rapporter at tiden er nogle få sekunder før Epoch'en, så C-biblioteks omslagsfunktion aldrig angiver errno som et resultat af dette kald.

Argumentet tloc er forældet og bør altid være NULL i ny kode. Når tloc er NULL, så kan kaldet ikke fejle.

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

Oversættere af denne manual til dansk Joe Hansen <joedalton2@yahoo.dk>

Denne oversættelse er gratis dokumentation; læs GNU General Public License version 3 eller nyere for ophavsretbetingelser. Der er INGEN ANSVAR.

Hvis du støder på fejl i oversættelsen af ​​denne vejledning, skal du sende en besked til debian-l10n-danish@lists.debian.org.