Função GetTimeZoneInformation (timezoneapi.h)

Artigo
03/02/2024

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