База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

gmtime — функция за време в C23

`gmtime(timer)` от `<time.h>` преобразува посочената календарна стойност `time_t` в разбито UTC време в обект `struct tm`. Връща указател към резултата или null, ако UTC не е налично или стойността не може да се представи.

Версия: C23

Синтаксис

struct tm *gmtime(const time_t *timer);

gmtime(timer) от <time.h> преобразува посочената календарна стойност time_t в разбито UTC време в обект struct tm. Връща указател към резултата или null, ако UTC не е налично или стойността не може да се представи.

Примерът подава нулево time_t и в среда с Unix епоха печата 1970-01-01 4 0: дата, четвъртък като tm_wday == 4 и първи ден от годината като tm_yday == 0. C не определя числовото значение на нулево time_t; точната дата е свойство на платформата на примера.

Резултатът може да сочи споделен статичен обект, презаписван от следващ gmtime или localtime. Копирайте полетата и синхронизирайте нишките; C23 предлага и gmtime_r. tm_mon и tm_yday започват от нула, tm_year от 1900, а tm_isdst е нула за UTC. Винаги проверявайте null преди дереференция.

Примери

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

Резултат

1970-01-01 4 0

Примерът подава нулево `time_t` и в среда с Unix епоха печата `1970-01-01 4 0`: дата, четвъртък като `tm_wday == 4` и първи ден от годината като `tm_yday == 0`. C не определя числовото значение на нулево `time_t`; точната дата е свойство на платформата на примера.

Източници