Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

gmtime — časová funkce C23

`gmtime(timer)` z `<time.h>` převede označenou hodnotu kalendářního času `time_t` na rozložené UTC v objektu `struct tm`. Vrací ukazatel na výsledek, nebo null, pokud UTC není dostupné či hodnotu nelze reprezentovat.

Verze: C23

Syntaxe

struct tm *gmtime(const time_t *timer);

gmtime(timer) z <time.h> převede označenou hodnotu kalendářního času time_t na rozložené UTC v objektu struct tm. Vrací ukazatel na výsledek, nebo null, pokud UTC není dostupné či hodnotu nelze reprezentovat.

Příklad předá nulové time_t a v prostředí s unixovou epochou vytiskne 1970-01-01 4 0: datum, čtvrtek jako tm_wday == 4 a první den roku jako tm_yday == 0. C číselný význam nulového time_t neurčuje; přesné datum je vlastností platformy příkladu.

Výsledek může označovat sdílený statický objekt přepsaný dalším gmtime či localtime. Potřebná pole zkopírujte a vlákna synchronizujte; C23 nabízí i gmtime_r. tm_mon a tm_yday začínají nulou, tm_year rokem 1900 a tm_isdst je pro UTC nula. Před dereferencí vždy testujte null.

Příklady

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

Výsledek

1970-01-01 4 0

Příklad předá nulové `time_t` a v prostředí s unixovou epochou vytiskne `1970-01-01 4 0`: datum, čtvrtek jako `tm_wday == 4` a první den roku jako `tm_yday == 0`. C číselný význam nulového `time_t` neurčuje; přesné datum je vlastností platformy příkladu.

Zdroje