localTime, _localtime32, _localtime64
Converter um valor de tempo e corrigir o fuso horário local.Versões mais seguras dessas funções estão disponíveis; see localtime_s, _localtime32_s, _localtime64_s.
struct tm *localtime(
const time_t *timer
);
struct tm *_localtime32(
const __time32_t *timer
);
struct tm *_localtime64(
const __time64_t *timer
);
Parâmetros
- timer
Ponteiro para o tempo armazenado.
Valor de retorno
Retornar um ponteiro para o resultado da estrutura, ou NULL se a data é passado para a função é:
Antes da meia-noite, de 1º de janeiro de 1970.
Após 03: 14: 07, 19 de janeiro de 2038, UTC (usando _time32 e time32_t).
Após 23: 59: 59, 31 de dezembro de 3000, UTC (usando _time64 e __time64_t).
_localtime64, que usa a __time64_t estruturar, permite que as datas a ser expressa até a 23: 59: 59, 31 de dezembro de 3000, a hora universal coordenada (UTC), enquanto _localtime32 representa as datas até 03: 14: 07 em 19 de janeiro de 2038, UTC.
localtimeé uma função in-line que é avaliada como _localtime64, e time_t é equivalente a __time64_t.Se você precisar forçar o compilador para interpretar time_tcomo o antigo 32-bit time_t, você pode definir _USE_32BIT_TIME_T.Fazendo isso fará com que localtime a ser avaliada como _localtime32.Isso não é recomendado porque seu aplicativo pode falhar após 19 de janeiro de 2038, e não é permitido em plataformas de 64 bits.
Os campos do tipo structure tm armazenar os valores a seguir, cada um deles é um int:
tm_sec
Segundos após minuto (0 – 59).tm_min
Minutos após hora (0 – 59).tm_hour
Horas após 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 atual menos 1900).tm_wday
Dia da semana (0 – 6; Domingo = 0).tm_yday
Dia do ano (0 – 365 dias por ano; 1º De janeiro = 0).tm_isdst
Valor positivo se o horário de verão está em vigor; 0 se o horário de verão não está em vigor. valor negativo se o status do horário de verão é desconhecido.Se a TZ a variável de ambiente é definida, a biblioteca de tempo de execução c assume regras apropriadas para os Estados Unidos para implementar o cálculo do – horário de verão (DST).
Comentários
O localtime função converte um horário armazenado como um time_t valor e armazena o resultado em uma estrutura do tipo tm.O long valor timer representa os segundos passados desde meia-noite (00: 00), 1 de janeiro de 1970, UTC.Esse valor normalmente é obtido a partir do time função.
Ambas as versões de 32 bits e 64 bits do gmtime, mktime, mkgmtime, e localtime todos usam um único tm estrutura por thread para a conversão.Cada chamada para uma dessas rotinas destrói o resultado da chamada anterior.
localtimecorrige o fuso horário local se o usuário primeiro definir a variável de ambiente global TZ.Quando TZ for definido, três outras variáveis de ambiente (_timezone, _daylight, e _tzname) são definidas automaticamente também.Se a TZ variável não estiver definido, localtime tenta usar as informações de fuso horário especificadas no aplicativo de data/hora no painel de controle.Se essa informação não pode ser obtida, PST8PDT, o que significa o fuso horário do Pacífico, é usado por padrão.Consulte _tzset para obter uma descrição dessas variáveis.TZé uma extensão da Microsoft e não faz parte da definição padrão ANSI de localtime.
Observação |
---|
O ambiente de destino deve tentar determinar se o horário de verão está em vigor. |
Essas funções validam seus parâmetros.Se timer é um ponteiro nulo ou se o valor do timer for negativo, essas funções invocar um manipulador de parâmetro inválido, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, as funções retornam NULL e defina errno para EINVAL.
Requisitos
Rotina |
Cabeçalho necessário |
---|---|
localtime |
<time.h> |
_localtime32 |
<time.h> |
_localtime64 |
<time.h> |
Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.
Exemplo
// crt_localtime.cpp
// compile with: /W3
/* This program uses _time64 to get the current time
* and then uses localtime64() to convert this time to a structure
* representing the local time. The program converts the result
* from a 24-hour clock to a 12-hour clock and determines the
* proper extension (AM or PM).
*/
#include <stdio.h>
#include <string.h>
#include <time.h>
int main( void )
{
struct tm *newtime;
char am_pm[] = "AM";
__time64_t long_time;
_time64( &long_time ); // Get time as 64-bit integer.
// Convert to local time.
newtime = _localtime64( &long_time ); // C4996
// Note: _localtime64 deprecated; consider _localetime64_s
if( newtime->tm_hour > 12 ) // Set up extension.
strcpy_s( am_pm, sizeof(am_pm), "PM" );
if( newtime->tm_hour > 12 ) // Convert from 24-hour
newtime->tm_hour -= 12; // to 12-hour clock.
if( newtime->tm_hour == 0 ) // Set hour to 12 if midnight.
newtime->tm_hour = 12;
char buff[30];
asctime_s( buff, sizeof(buff), newtime );
printf( "%.19s %s\n", buff, am_pm );
}
Equivalência do .NET Framework
Consulte também
Referência
a ctime, _ctime32, _ctime64, _wctime, _wctime32, _wctime64