WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen