CKTIS / C
gmtime — función de tiempo de C23
`gmtime(timer)` de `<time.h>` convierte el valor de tiempo de calendario `time_t` señalado en UTC descompuesto dentro de un objeto `struct tm`. Devuelve un puntero al resultado, o null si UTC no está disponible o el valor no puede representarse.
Versión: C23
Sintaxis
struct tm *gmtime(const time_t *timer);gmtime(timer) de <time.h> convierte el valor de tiempo de calendario time_t señalado en UTC descompuesto dentro de un objeto struct tm. Devuelve un puntero al resultado, o null si UTC no está disponible o el valor no puede representarse.
El ejemplo pasa un time_t cero y, en el entorno con época Unix, muestra 1970-01-01 4 0: fecha, jueves como tm_wday == 4 y primer día del año como tm_yday == 0. C no define el significado numérico de cero time_t, así que esa fecha pertenece a la plataforma del ejemplo.
El resultado puede señalar un objeto estático compartido que sobrescriben llamadas posteriores a gmtime o localtime. Copia los campos y sincroniza hilos; C23 también ofrece gmtime_r. tm_mon y tm_yday empiezan en cero, tm_year en 1900 y tm_isdst vale cero para UTC. Comprueba null antes de desreferenciar.
Ejemplos
#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
El ejemplo pasa un `time_t` cero y, en el entorno con época Unix, muestra `1970-01-01 4 0`: fecha, jueves como `tm_wday == 4` y primer día del año como `tm_yday == 0`. C no define el significado numérico de cero `time_t`, así que esa fecha pertenece a la plataforma del ejemplo.