Compartilhar via


Função GetTimeZoneInformation (timezoneapi.h)

Recupera as configurações atuais de fuso horário. Essas configurações controlam as traduções entre o UTC (Tempo Universal Coordenado) e a hora local.

Para dar suporte a limites para o horário de verão que mudam de ano para ano, use a função GetDynamicTimeZoneInformation ou GetTimeZoneInformationForYear .

Sintaxe

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

Parâmetros

[out] lpTimeZoneInformation

Um ponteiro para uma estrutura TIME_ZONE_INFORMATION para receber as configurações atuais.

Retornar valor

Se a função for bem-sucedida, ela retornará um dos valores a seguir.

Valor/código retornado Descrição
TIME_ZONE_ID_UNKNOWN
0
O horário de verão não é usado no fuso horário atual, pois não há datas de transição ou o ajuste automático para o horário de verão está desabilitado.
TIME_ZONE_ID_STANDARD
1
O sistema está operando no intervalo coberto pelo membro StandardDate da estrutura TIME_ZONE_INFORMATION .
TIME_ZONE_ID_DAYLIGHT
2
O sistema está operando no intervalo coberto pelo membro DaylightDate da estrutura TIME_ZONE_INFORMATION .
 

Se a função falhar por outros motivos, como um erro de memória insuficiente, ela retornará TIME_ZONE_ID_INVALID. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Todas as traduções entre a hora UTC e a hora local são baseadas na seguinte fórmula:

UTC = hora local + viés

O viés é a diferença, em minutos, entre a hora UTC e a hora local.

Os membros StandardName e DaylightName da estrutura de TIME_ZONE_INFORMATION resultante são localizados de acordo com a linguagem de interface do usuário padrão do usuário atual.

Exemplos

Para obter um exemplo, consulte SetTimeZoneInformation.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho timezoneapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

GetDynamicTimeZoneInformation

GetTimeZoneInformationForYear

Hora Local

SetTimeZoneInformation

TIME_ZONE_INFORMATION

Funções de tempo