gmtime, _gmtime32, _gmtime64

Artículo
04/10/2013

Convierte un valor de hora a una estructura.Versiones más seguras de estas funciones están disponibles; vea gmtime_s, _gmtime32_s, _gmtime64_s.

struct tm *gmtime( 
   const time_t *timer 
);
struct tm *_gmtime32( 
   const time32_t *timer 
);
struct tm *_gmtime64( 
   const __time64_t *timer 
);

Parámetros

timer
Puntero al tiempo almacenado.El tiempo se representa como segundos transcurridos desde la medianoche (00:00: 00), el 1 de enero de 1970, hora universal coordinada (UTC) (UTC).

Valor devuelto

Devuelve un puntero a una estructura de TMescrito.Los campos de bloqueo devuelto de estructura el valor evaluado del argumento de timer en hora UTC en lugar de en hora local.Cada uno de los campos de la estructura es de inttipo, como sigue:

tm_sec
Segundos después de min (0 – 59).
tm_min
minutos después de la hora (0 – 59).
tm_hour
horas desde la medianoche (0 – 23).
tm_mday
Día del mes (1 – 31).
tm_mon
mes (0 – 11; enero = 0).
tm_year
Año (año actual menos 1900).
tm_wday
día de la semana (0 – 6; domingo = 0).
tm_yday
Día del año (0 – 365; 1 de enero = 0).
tm_isdst
siempre 0 para gmtime.

La versión de 32 bits y la de 64 bits de gmtime, de mktime, de mkgmtime, y delocaltimetodos utilizan una única estructura de tm por el subproceso para la conversión.Cada llamada a una de estas funciones destruye el resultado de cualquier llamada anterior.si timer representa una fecha antes de medianoche, el 1 de enero de 1970, gmtime devuelve NULL.No hay retorno de error.

_gmtime64, que utiliza la estructura de __time64_t , permite que las fechas están expresadas hacia arriba con 23:59: 59, el 31 de diciembre, 3000, la hora UTC, mientras que _gmtime32 sólo representa las fechas con 03:14: 7 de enero de 19, 2038, La hora UTC.La medianoche, el 1 de enero de 1970, es el límite inferior del intervalo de fechas para estas funciones.

gmtime es una función inline que se evalúa como _gmtime64 y time_t es equivalente a __time64_t.Si necesita hacer que el compilador para interpretar time_t como time_tde 32 bits anterior, puede definir _USE_32BIT_TIME_T.Ello producirá gmtime en-que se alineará a _gmtime32.Esto no es recomendable porque la aplicación puede producir un error después del 18 de enero de 2038, y no se permite en plataformas de 64 bits.

Estas funciones validan el parámetro.Si timer es un puntero null, o si el valor del temporizador es negativo, estas funciones se invoca un controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, las funciones NULL return y errno determinado a EINVAL.

Comentarios

La función de _gmtime32 analiza el valor de timer y lo almacena en una estructura estáticamente asignada de tmescrito, definido en TIME.H.El valor de timer se obtiene normalmente de una llamada a la función de time .

[!NOTA]

El entorno de destino debe intentar determinar si el horario de verano está vigente.La biblioteca en tiempo de ejecución de C supone las reglas de los Estados Unidos para implementar el cálculo en tiempo de Daylight Guardar (DST).

Requisitos

rutina	Encabezado necesario
gmtime	<time.h>
_gmtime32	<time.h>
_gmtime64	<time.h>

Para obtener información adicional de compatibilidad, vea compatibilidad en la Introducción.

Ejemplo

// crt_gmtime.c
// compile with: /W3
// This program uses _gmtime64 to convert a long-
// integer representation of coordinated universal time
// to a structure named newtime, then uses asctime to
// convert this structure to an output string.
 
#include <time.h>
#include <stdio.h>

int main( void )
{
   struct tm *newtime;
   __int64 ltime;
   char buff[80];

   _time64( &ltime );

   // Obtain coordinated universal time:
   newtime = _gmtime64( &ltime ); // C4996
   // Note: _gmtime64 is deprecated; consider using _gmtime64_s
   asctime_s( buff, sizeof(buff), newtime );
   printf( "Coordinated universal time is %s\n", buff );
}