Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

time — pobieranie bieżącego czasu kalendarzowego

Funkcja time z <time.h> zwraca przybliżenie bieżącego czasu kalendarzowego jako time_t; sprawdzaj wynik (time_t)(-1).

Wersja: C23; repository compiler flag, production runtime not attested

Składnia

#include <time.h>
time_t time(time_t *timer);

time zwraca najlepsze dostępne w implementacji przybliżenie bieżącego czasu kalendarzowego. Gdy czas jest niedostępny, zwraca (time_t)(-1). Sprawdzaj ten wynik przed użyciem wartości.

Wywołanie time(NULL) tylko zwraca wynik. Przy niepustym wskaźniku, jak w time(&stored), funkcja dodatkowo zapisuje zwracaną wartość we wskazanym obiekcie typu time_t.

Kodowanie czasu jest nieokreślone: przenośny kod nie może zakładać sekund od epoki Unix. Przykład porównuje zapisany wynik ze zwróconym, zamiast wypisywać zmienną datę.

Przykłady

#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;
}

Wynik

Values match

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła