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.