CKTIS / C
gmtime — função de tempo C23
`gmtime(timer)` de `<time.h>` converte o valor de tempo de calendário `time_t` indicado em UTC decomposto num objeto `struct tm`. Devolve ponteiro para o resultado, ou null se UTC não estiver disponível ou o valor não puder ser representado.
Versão: C23
Sintaxe
struct tm *gmtime(const time_t *timer);gmtime(timer) de <time.h> converte o valor de tempo de calendário time_t indicado em UTC decomposto num objeto struct tm. Devolve ponteiro para o resultado, ou null se UTC não estiver disponível ou o valor não puder ser representado.
O exemplo passa time_t zero e, no ambiente com época Unix, imprime 1970-01-01 4 0: data, quinta-feira como tm_wday == 4 e primeiro dia do ano como tm_yday == 0. C não define o significado numérico de zero time_t, pelo que esta data pertence à plataforma do exemplo.
O resultado pode indicar objeto estático partilhado sobrescrito por chamadas seguintes a gmtime ou localtime. Copia os campos e sincroniza threads; C23 também fornece gmtime_r. tm_mon e tm_yday começam em zero, tm_year em 1900 e tm_isdst vale zero para UTC. Testa sempre null antes de desreferenciar.
Exemplos
#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;}
Resultado
1970-01-01 4 0
O exemplo passa `time_t` zero e, no ambiente com época Unix, imprime `1970-01-01 4 0`: data, quinta-feira como `tm_wday == 4` e primeiro dia do ano como `tm_yday == 0`. C não define o significado numérico de zero `time_t`, pelo que esta data pertence à plataforma do exemplo.