time

 

C

Compiler-Unterstützung

Sprache

Header

Typunterstützung

Programm-Dienstprogramme

Unterstützung für variable Funktionsargumente

Fehlerbehandlung

Dynamische Speicherverwaltung

Bibliothek für Zeichenketten

Algorithmen

Numerik

Datums- und Zeitdienstprogramme

Ein-/Ausgabeunterstützung

Lokalisierungsunterstützung

Unterstützung für Nebenläufigkeit (C11)

Technische Spezifikationen

Symbolindex

 

Datums- und Zeitdienstprogramme

Funktionen

Zeitmanipulation

difftime

time

clock

timespec_get (C11)

timespec_getres (C23)

Formatkonvertierungen

asctimeasctime_s (in C23 veraltet)(C11)

ctimectime_s (in C23 veraltet)(C11)

strftime

wcsftime (C95)

gmtimegmtime_rgmtime_s (C23)(C11)

localtimelocaltime_rlocaltime_s (C23)(C11)

mktime

Konstanten

CLOCKS_PER_SEC

Typen

tm

time_t

clock_t

timespec (C11)

 

Definiert in Header <time.h>
time_t time( time_t* arg );

Gibt die aktuelle Kalenderzeit zurück, kodiert als time_t-Objekt, und speichert sie auch im time_t-Objekt, auf das von arg gezeigt wird (es sei denn, arg ist ein Nullzeiger)

Parameter

arg

-

Zeiger auf ein time_t-Objekt, in dem die Zeit gespeichert wird, oder ein Nullzeiger

Rückgabewert

Aktuelle Kalenderzeit, kodiert als time_t-Objekt bei Erfolg, (time_t)(-1) bei Fehler. Wenn arg kein Nullzeiger ist, wird der Rückgabewert auch im Objekt gespeichert, auf das von arg gezeigt wird.

Hinweise

Die Kodierung der Kalenderzeit in time_t ist nicht spezifiziert, aber die meisten Systeme halten sich an die POSIX-Spezifikation und geben einen Wert von integralem Typ zurück, der die Anzahl der Sekunden seit der Epoche enthält. Implementierungen, bei denen time_t ein 32-Bit-Vorzeichenbehafteter Integer ist (viele historische Implementierungen), scheitern im Jahr 2038.

Beispiel

Führen Sie diesen Code aus

#include <stdint.h>
#include <stdio.h>
#include <time.h>
 
int main(void)
{
    time_t result = time(NULL);
    if (result != (time_t)(-1))
        printf("The current time is %s(%jd seconds since the Epoch)\n",
               asctime(gmtime(&result)), (intmax_t)result);
}

Mögliche Ausgabe

The current time is Fri Apr 24 15:05:25 2015
(1429887925 seconds since the Epoch)

Referenzen

• C23-Standard (ISO/IEC 9899:2024)

• 7.27.2.4 Die time-Funktion (p: TBD)

• C17-Standard (ISO/IEC 9899:2018)

• 7.27.2.4 Die time-Funktion (p: 286)

• C11-Standard (ISO/IEC 9899:2011)

• 7.27.2.4 Die time-Funktion (p: 391)

• C99-Standard (ISO/IEC 9899:1999)

• 7.23.2.4 Die time-Funktion (p: 341)

• C89/C90-Standard (ISO/IEC 9899:1990)

• 4.12.2.4 Die time-Funktion

Siehe auch

localtimelocaltime_rlocaltime_s (C23)(C11)	konvertiert Zeit seit Epoche in Kalenderzeit, ausgedrückt als lokale Zeit (Funktion)
gmtimegmtime_rgmtime_s (C23)(C11)	konvertiert Zeit seit Epoche in Kalenderzeit, ausgedrückt als koordinierte Weltzeit (UTC) (Funktion)
timespec_get (C11)	gibt die Kalenderzeit in Sekunden und Nanosekunden basierend auf einer gegebenen Zeitbasis zurück (Funktion)
C++ Dokumentation für time