oracular (2) time.2.gz

Provided by: manpages-de-dev_4.23.1-1_all bug

BEZEICHNUNG

       time - Zeit in Sekunden abfragen

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #include <time.h>

       time_t time(time_t *_Nullable tloc);

BESCHREIBUNG

       time()  gibt  die  Zeit  als Anzahl der Sekunden seit dem Beginn der Unixzeit am 1.1.1970, 00:00:00 +0000
       (UTC) an.

       Falls tloc nicht NULL ist, wird der Rückgabewert auch im Speicher an der Stelle abgelegt,  auf  die  tloc
       zeigt.

RÜCKGABEWERT

       Bei  Erfolg  wird die Zeit seit Beginn der Unixzeit in Sekunden zurückgegeben. Tritt ein Fehler auf, wird
       ((time_t) -1) zurückgegeben und errno gesetzt, um den Fehler anzuzeigen.

FEHLER

       EOVERFLOW
              Die Zeit kann nicht als ein time_t-Wert dargestellt werden. Dies kann passieren, wenn ein Programm
              mit einem 32 bit time_t auf einem 64-bit-Kernel ausgeführt wird, wenn die Zeit 2038-01-19 03:14:08
              UTC oder später ist. Ist die Systemzeit in anderen Situationen außerhalb des Bereichs  von  time_t
              ist das Verhalten allerdings undefiniert.

       EFAULT tloc zeigt außerhalb Ihres verfügbaren Adressbereichs (siehe aber auch FEHLER).

              Auf  Systemen, auf denen die C-Bibliothek-time()-Wrapper-Funktion eine von vdso(7) bereitgestellte
              Implementierung aufruft (so dass es keine Verbindung in den  Kernel  gibt),  kann  eine  ungültige
              Adresse stattdessen ein SIGSEGV-Signal auslösen.

VERSIONEN

       POSIX.1 definiert die Sekunden seit Anfang der Unixzeit mittels einer Formel, die die Anzahl der Sekunden
       zwischen einem bestimmten Zeitpunkt und dem Anfang der »Unixzeit« abschätzt. Diese Formel  berücksichtigt
       die  Tatsache,  dass alle durch vier ohne Rest teilbaren Jahre Schaltjahre sind. Alle durch 100 ohne Rest
       teilbaren Jahre sind keine Schaltjahre, es sei denn, sie sind gleichzeitig durch 400 ohne  Rest  teilbar,
       dann  sind  es  wiederum  Schaltjahre.  Dieser Wert entspricht nicht der tatsächlichen Anzahl an Sekunden
       zwischen  dem  angegebenen  Zeitpunkt  und  dem  Anfang  der  »Unixzeit«,   weil   Schaltsekunden   nicht
       berücksichtigt  werden  und  es  nicht  erforderlich  ist,  dass  Systemuhren  mit einer Standardreferenz
       synchronisiert  werden.  Linux-System  folgen  normalerweise  der  POSIX-Anforderung,  dass  dieser  Wert
       Schaltsekunden   ignoriert,  so  dass  standardgerechte  Systeme  ihn  konsistent  interpretieren;  siehe
       POSIX.1-2018 Rationale A.4.16.

       Anwendungen, die nach 2038 laufen sollen, sollten ABIs mit time_t breiter als  32  bit  verwenden,  siehe
       time_t(3type).

   Unterschiede C-Bibliothek/Kernel
       Auf einigen Architekturen wird eine Implementierung von time() in einem vdso(7) bereitgestellt.

STANDARDS

       C11, POSIX.1-2008.

GESCHICHTE

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

FEHLER

       Fehler,  die  von  diesem Systemaufruf zurückgegeben werden, sind nicht von erfolgreichen Berichten, dass
       die  Zeit  ein  paar  Sekunden   vor   der   Unixzeit   liegt,   zu   unterscheiden.   Daher   kann   die
       C-Bibliothek-Wrapper-Funktion errno nie als Ergebnis dieses Aufrufs setzen.

       Das  Argument  tloc  ist  veraltet und sollte in neuem Code immer NULL sein. Wenn tloc NULL ist, kann der
       Aufruf nicht fehlschlagen.

SIEHE AUCH

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

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Michael Haardt  <michael@moria.de>,  Ralf  Demmer
       <rdemmer@rdemmer.de>,  Chris  Leick  <c.leick@vollbio.de>  und  Helge  Kreutzmann  <debian@helgefjell.de>
       erstellt.

       Diese Übersetzung  ist  Freie  Dokumentation;  lesen  Sie  die  GNU  General  Public  License  Version  3
       ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE
       HAFTUNG übernommen.

       Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte  eine  E-Mail  an  die
       Mailingliste der Übersetzer ⟨debian-l10n-german@lists.debian.org⟩.