Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / C

gmtime — časová funkcia C23

`gmtime(timer)` z `<time.h>` prevedie označenú hodnotu kalendárneho času `time_t` na rozložené UTC v objekte `struct tm`. Vracia ukazovateľ na výsledok alebo null, ak UTC nie je dostupné či hodnotu nemožno reprezentovať.

Verzia: C23

Syntax

struct tm *gmtime(const time_t *timer);

gmtime(timer) z <time.h> prevedie označenú hodnotu kalendárneho času time_t na rozložené UTC v objekte struct tm. Vracia ukazovateľ na výsledok alebo null, ak UTC nie je dostupné či hodnotu nemožno reprezentovať.

Príklad odovzdá nulové time_t a v prostredí s unixovou epochou vytlačí 1970-01-01 4 0: dátum, štvrtok ako tm_wday == 4 a prvý deň roka ako tm_yday == 0. C číselný význam nulového time_t neurčuje; presný dátum je vlastnosťou platformy príkladu.

Výsledok môže označovať zdieľaný statický objekt prepísaný ďalším gmtime či localtime. Potrebné polia skopírujte a vlákna synchronizujte; C23 ponúka aj gmtime_r. tm_mon a tm_yday začínajú nulou, tm_year rokom 1900 a tm_isdst je pre UTC nula. Pred dereferenciou vždy testujte null.

Prí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ýsledok

1970-01-01 4 0

Príklad odovzdá nulové `time_t` a v prostredí s unixovou epochou vytlačí `1970-01-01 4 0`: dátum, štvrtok ako `tm_wday == 4` a prvý deň roka ako `tm_yday == 0`. C číselný význam nulového `time_t` neurčuje; presný dátum je vlastnosťou platformy príkladu.

Zdroje