Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes