CKTIS / C
time — die aktuelle Kalenderzeit abrufen
Die Funktion time aus <time.h> liefert eine Näherung der aktuellen Kalenderzeit als time_t; prüfe auf (time_t)(-1).
Version: C23; repository compiler flag, production runtime not attested
Syntax
#include <time.h>
time_t time(time_t *timer);time liefert die bestmögliche, von der Implementierung bereitgestellte Näherung der aktuellen Kalenderzeit. Ist die Zeit nicht verfügbar, wird (time_t)(-1) zurückgegeben. Prüfe dieses Ergebnis, bevor du den Wert verwendest.
Der Aufruf time(NULL) gibt nur das Ergebnis zurück. Bei einem Zeiger ungleich null, wie in time(&stored), speichert die Funktion den zurückgegebenen Wert zusätzlich im referenzierten Objekt vom Typ time_t.
Die Kodierung der Zeit ist nicht festgelegt: Portabler Code darf nicht annehmen, dass es sich um Sekunden seit der Unix-Epoche handelt. Das Beispiel vergleicht den gespeicherten mit dem zurückgegebenen Wert, statt ein sich änderndes Datum auszugeben.
Beispiele
#include <stdio.h>
#include <time.h>
int main(void)
{
time_t stored;
time_t result = time(&stored);
if (result == (time_t)(-1)) {
puts("Time unavailable");
return 1;
}
puts(stored == result ? "Values match" : "Values differ");
return 0;
}Ergebnis
Values match
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.