Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / C

gmtime — časovna funkcija C23

`gmtime(timer)` iz `<time.h>` pretvori označeno koledarsko vrednost `time_t` v razčlenjeni UTC v objektu `struct tm`. Vrne kazalec na rezultat ali null, če UTC ni na voljo oziroma vrednosti ni mogoče predstaviti.

Različica: C23

Sintaksa

struct tm *gmtime(const time_t *timer);

gmtime(timer) iz <time.h> pretvori označeno koledarsko vrednost time_t v razčlenjeni UTC v objektu struct tm. Vrne kazalec na rezultat ali null, če UTC ni na voljo oziroma vrednosti ni mogoče predstaviti.

Primer poda ničelni time_t in v okolju z Unixovo epoho izpiše 1970-01-01 4 0: datum, četrtek kot tm_wday == 4 ter prvi dan leta kot tm_yday == 0. C ne določa številskega pomena ničelnega time_t; točen datum je lastnost platforme primera.

Rezultat lahko kaže skupni statični objekt, ki ga prepiše naslednji gmtime ali localtime. Polja kopirajte in niti sinhronizirajte; C23 ponuja tudi gmtime_r. tm_mon in tm_yday se začneta z nič, tm_year z letom 1900, tm_isdst pa je za UTC nič. Pred dereferenciranjem vedno preverite null.

Primeri

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

Rezultat

1970-01-01 4 0

Primer poda ničelni `time_t` in v okolju z Unixovo epoho izpiše `1970-01-01 4 0`: datum, četrtek kot `tm_wday == 4` ter prvi dan leta kot `tm_yday == 0`. C ne določa številskega pomena ničelnega `time_t`; točen datum je lastnost platforme primera.

Viri