Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

localtime — funkcja czasu C23

`localtime(timer)` z `<time.h>` przekształca wskazany `time_t` na lokalny czas kalendarzowy i zwraca wskaźnik do `struct tm`; uwzględnia reguły strefy czasowej i czasu letniego środowiska. Przy niepowodzeniu może zwrócić null.

Wersja: C23

Składnia

struct tm *localtime(const time_t *timer);

localtime(timer) z <time.h> przekształca wskazany time_t na lokalny czas kalendarzowy i zwraca wskaźnik do struct tm; uwzględnia reguły strefy czasowej i czasu letniego środowiska. Przy niepowodzeniu może zwrócić null.

Przykład przekazuje time_t równy zero do localtime i sprawdza wskaźnik oraz zakresy pól miesiąca, dnia, godziny, minut i sekund. W środowisku wykonania drukuje 1, nie zakładając konkretnej strefy.

Wynik wskazuje statyczny obiekt, który kolejne localtime, gmtime lub ctime może nadpisać; skopiuj struct tm natychmiast. Funkcja nie jest wymagana jako bezpieczna przy równoległych wywołaniach. tm_isdst może być dodatnie, zero lub ujemne, a niejednoznaczne i nieistniejące czasy lokalne przy zmianie DST wymagają ostrożności przy odwrotnym mktime.

Przykłady

#include <stdio.h>
#include <time.h>
int main(void){time_t raw=0;struct tm *v=localtime(&raw);int ok=v&&v->tm_mon>=0&&v->tm_mon<=11&&v->tm_mday>=1&&v->tm_mday<=31&&v->tm_hour>=0&&v->tm_hour<=23&&v->tm_min>=0&&v->tm_min<=59&&v->tm_sec>=0&&v->tm_sec<=60;printf("%d\n",ok);return 0;}

Wynik

1

Przykład przekazuje `time_t` równy zero do `localtime` i sprawdza wskaźnik oraz zakresy pól miesiąca, dnia, godziny, minut i sekund. W środowisku wykonania drukuje `1`, nie zakładając konkretnej strefy.

Źródła