Namespaces
Variants

time

From cppreference.net
C
Date and time utilities
Functions
Time manipulation
time
(C11)
(C23)
Format conversions
(deprecated in C23) (C11)
(deprecated in C23) (C11)
(C95)
(C23) (C11)
(C23) (C11)
Constants
Types
(C11)
Definiert in Header <time.h>
time_t time ( time_t * arg ) ;

Gibt die aktuelle Kalenderzeit kodiert als ein time_t Objekt zurück und speichert sie ebenfalls im time_t Objekt, auf das arg zeigt (sofern arg kein Nullzeiger ist)

Inhaltsverzeichnis

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. Falls arg kein Nullzeiger ist, wird der Rückgabewert ebenfalls im Objekt gespeichert, auf das arg zeigt.

Hinweise

Die Kodierung der Kalenderzeit in time_t ist nicht spezifiziert, aber die meisten Systeme entsprechen der POSIX-Spezifikation und geben einen Wert ganzzahligen Typs zurück, der die Anzahl der Sekunden seit der Epoche enthält. Implementierungen, in denen time_t ein 32-Bit vorzeichenbehafteter Integer ist (viele historische Implementierungen), versagen im Jahr 2038 .

Beispiel

Diesen Code ausführen 
#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 (S.: TBD)
  • C17-Standard (ISO/IEC 9899:2018):
  • 7.27.2.4 Die time-Funktion (S: 286)
  • C11-Standard (ISO/IEC 9899:2011):
  • 7.27.2.4 Die time-Funktion (S: 391)
  • C99-Standard (ISO/IEC 9899:1999):
  • 7.23.2.4 Die time-Funktion (S: 341)
  • C89/C90-Standard (ISO/IEC 9899:1990):
  • 4.12.2.4 Die time-Funktion

Siehe auch

(C23) (C11)
wandelt Zeit seit Epoche in Kalenderzeit ausgedrückt als Ortszeit um
(Funktion)
(C23) (C11)
wandelt Zeit seit Epoche in Kalenderzeit ausgedrückt als Koordinierte Weltzeit (UTC) um
(Funktion)
(C11)
gibt die Kalenderzeit in Sekunden und Nanosekunden basierend auf einer gegebenen Zeitbasis zurück
(Funktion)
C++-Dokumentation für time