Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

gmtime — funkcja czasu C23

`gmtime(timer)` z `<time.h>` przekształca wskazaną wartość czasu kalendarzowego `time_t` na rozłożony czas UTC w obiekcie `struct tm`. Zwraca wskaźnik do wyniku albo null, gdy czas UTC nie jest dostępny lub wartości nie da się przedstawić.

Wersja: C23

Składnia

struct tm *gmtime(const time_t *timer);

gmtime(timer) z <time.h> przekształca wskazaną wartość czasu kalendarzowego time_t na rozłożony czas UTC w obiekcie struct tm. Zwraca wskaźnik do wyniku albo null, gdy czas UTC nie jest dostępny lub wartości nie da się przedstawić.

Przykład przekazuje time_t równe zero i w środowisku z epoką Unix wypisuje 1970-01-01 4 0: datę, czwartek jako tm_wday == 4 i pierwszy dzień roku jako tm_yday == 0. C nie definiuje znaczenia liczbowego zera time_t, więc ten wynik jest właściwością platformy przykładu.

Wynik może wskazywać współdzielony obiekt statyczny nadpisywany przez następne gmtime lub localtime, dlatego potrzebne pola skopiuj przed kolejnym wywołaniem i synchronizuj wątki; C23 udostępnia też gmtime_r. tm_mon i tm_yday są liczone od zera, tm_year od 1900, a tm_isdst dla UTC wynosi zero. Zawsze sprawdzaj null przed dereferencją.

Przykłady

#include <stdio.h>
#include <time.h>
int main(void){time_t value=(time_t)0;struct tm *utc=gmtime(&value);if(!utc)return 1;printf("%04d-%02d-%02d %d %d\n",utc->tm_year+1900,utc->tm_mon+1,utc->tm_mday,utc->tm_wday,utc->tm_yday);return 0;}

Wynik

1970-01-01 4 0

Przykład przekazuje `time_t` równe zero i w środowisku z epoką Unix wypisuje `1970-01-01 4 0`: datę, czwartek jako `tm_wday == 4` i pierwszy dzień roku jako `tm_yday == 0`. C nie definiuje znaczenia liczbowego zera `time_t`, więc ten wynik jest właściwością platformy przykładu.

Źródła