gmtime _gmtime32, _gmtime64

Artigo
08/25/2010

Converter um time valor para uma estrutura.Versões mais seguras dessas funções estão disponível; consulte _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
Ponteiro para a time armazenado.O time é representado sistema autônomo segundos passados desde meia-noite (00: 00: 00), 1 º de janeiro de 1970, formato time universal coordenado (UTC).

Valor de retorno

Retornar um ponteiro para uma estrutura do tipo TM.Os campos da estrutura retornado Isenção o valor avaliado do timer argumento em UTC, em vez de time local. Cada um dos campos de estrutura de é do tipo int, sistema autônomo segue:

tm_sec
Segundos após minuto (0 – 59).
tm_min
Minutos após hora (0 – 59).
tm_hour
Horas desde a meia-noite (0 – 23).
tm_mday
Dia do mês (1 – 31).
tm_mon
Mês (0 – 11; janeiro = 0).
tm_year
Ano (ano corrente menos 1900).
tm_wday
Dia da semana (0 – 6; domingo = 0).
tm_yday
Dia do ano (0 – 1 º de janeiro; 365 = 0).
tm_isdst
Sempre 0 para gmtime.

Both the 32-bit and 64-bit versions of gmtime, mktime, mkgmtime, and localtimeall use a single tm structure per thread for the conversion.Cada telefonar para uma dessas funções destrói o resultado de qualquer telefonar anterior.If timer representa uma data antes da meia-noite, 1 º de janeiro de 1970 gmtime Retorna NULL. Não há nenhum retorno de erro.

_gmtime64, que usa o __time64_t estruturar, permite que as datas para ser expressa até a 23: 59: 59, 31 de dezembro de 3000, UTC, enquanto _gmtime32 apenas representam datas até 14: 03: 07 19 de janeiro de 2038, UTC. Meia-noite, 1 º de janeiro de 1970, é o limite inferior do intervalo de datas para ambas essas funções.

In Visual C++ 2005, gmtime é uma função in-line que é avaliada como _gmtime64e time_té equivalente a __time64_t. If you need to force the compiler to interpret time_t as the old 32-bit time_t, you can define _USE_32BIT_TIME_T.Isso fará com que gmtime seja com no-linhas para _gmtime32. Isso não é recomendado porque seu aplicativo pode falhar após 18.01.38, e não é permitido em plataformas de 64 bit.

Essas funções validam seus parâmetros.If timer é um ponteiro nulo ou se o valor do timer for negativo, essas funções chamar um manipulador de parâmetro inválido, sistema autônomo descrito em Validação de parâmetro. Se a execução for permitida para continuar, as funções retornam NULL e conjunto errno para EINVAL.

Comentários

The _gmtime32 função divide o timer valor e as armazena em uma estrutura estaticamente alocada do tipo tm, definido no TIME.H. O valor de timer geralmente são obtidas de uma telefonar para o time função.

Observação:
O ambiente de destino deve tentar determinar se o horário de verão está em vigor.Assume que a biblioteca de time de execução C o Estados Unidos regras para implementar o cálculo do Daylight Saving time (DST).

Requisitos

Rotina	Cabeçalho necessário
gmtime	<time.h>
_gmtime32	<time.h>
_gmtime64	<time.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

// 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 );
}

Coordinated universal time is Tue Feb 12 23:11:31 2002