_gmtime_s _gmtime32_s, _gmtime64_s

Artigo
08/25/2010

Converte um valor temporal em uma estrutura.Essas são sistema autônomo versões de _gmtime32, _gmtime64 com aprimoramentos de segurança conforme descrito em Aprimoramentos de segurança no CRT.

errno_t _gmtime_s(
   struct tm* _tm,
   const __time_t* time
);
errno_t _gmtime32_s(
   struct tm* _tm,
   const __time32_t* time
);
errno_t _gmtime64_s(
   struct tm* _tm,
   const __time64_t* time 
);

Parâmetros

_tm
Ponteiro para um tm estrutura. Os campos da estrutura retornado Isenção o valor avaliado do timer argumento em UTC, em vez de time local.
time
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

Zero se for bem-sucedido.O valor retornado é um código de erro se houver uma falha.Códigos de erro estão definidos no errno.h; para obter uma listagem desses erros, consulte errno.

Condições de erro

_tm	time	Return	Valor em _tm
NULL	any	EINVAL	Não modificado.
Not NULL (points to valid memory)	NULL	EINVAL	Todos os campos definidos como -1.
Not NULL	< 0	EINVAL	Todos os campos definidos como -1.

No caso de condições de duas erro primeira, o manipulador de parâmetro inválido é chamado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, essas funções conjunto errno para EINVAL e retornar EINVAL.

Comentários

The _gmtime32_s função divide o time valor e as armazena em uma estrutura estaticamente alocada do tipo tm, definido no Time.h. O valor de time 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 a implementação de cálculo de verão time.

Cada um dos campos de estrutura de é do tipo int, sistema autônomo mostrado na tabela a seguir.

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.

_gmtime64_s, 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_s 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_s é uma função in-line que é avaliada como _gmtime64_se 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_s seja com no-linhas para _gmtime32_s. Isso não é recomendado porque seu aplicativo pode falhar após 18.01.38, e não é permitido em plataformas de 64 bit.

Requisitos

Rotina	Cabeçalho necessário
_gmtime_s	<time.h>
_gmtime32_s	<time.h>
_gmtime64_s	<time.h>

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

Exemplo

// crt_gmtime64_s.c
// This program uses _gmtime64_s to convert a 64-bit
// integer representation of coordinated universal time
// to a structure named newtime, then uses asctime_s to
// convert this structure to an output string.
 

#include <time.h>
#include <stdio.h>

int main( void )
{
   struct tm newtime;
   __int64 ltime;
   char buf[26];
   errno_t err;

   _time64( &ltime );

   // Obtain coordinated universal time: 
   err = _gmtime64_s( &newtime, &ltime );
   if (err)
   {
      printf("Invalid Argument to _gmtime64_s.");
   }
   
   // Convert to an ASCII representation 
   err = asctime_s(buf, 26, &newtime);
   if (err)
   {
      printf("Invalid Argument to asctime_s.");
   }

   printf( "Coordinated universal time is %s\n", 
           buf );
}

Coordinated universal time is Fri Apr 25 20:12:33 2003