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`; точната дата е свойство на платформата на примера.