Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Converte a hora local especificada para a hora correspondente em UTC (Tempo Universal Coordenado).
Sintaxe
BOOL TzSpecificLocalTimeToSystemTime(
[in, optional] const TIME_ZONE_INFORMATION *lpTimeZoneInformation,
[in] const SYSTEMTIME *lpLocalTime,
[out] LPSYSTEMTIME lpUniversalTime
);
Parâmetros
[in, optional] lpTimeZoneInformation
Um ponteiro para uma estrutura de TIME_ZONE_INFORMATION que especifica o fuso horário para o horário especificado em lpLocalTime.
Se lpTimeZoneInformation for NULL, a função usará o fuso horário ativo no momento.
[in] lpLocalTime
Um ponteiro para uma estrutura SYSTEMTIME que especifica a hora local a ser convertida. A função converte desta vez para a hora UTC correspondente.
[out] lpUniversalTime
Um ponteiro para uma estrutura SYSTEMTIME que recebe a hora UTC.
Valor de retorno
Se a função for bem-sucedida, o valor retornado não será zero e a função definirá os membros da estrutura SYSTEMTIMEapontados por lpUniversalTime para os valores apropriados.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Observações
TzSpecificLocalTimeToSystemTime leva em conta se o horário de verão (DST) está em vigor para que a hora local seja convertida.
Importante
Os horários locais a seguir, próximos às transições de DST, podem ser ambíguos ou inválidos e podem resultar em um comportamento inesperado (já que não há nenhum resultado "correto" garantido).
- Durante a transição do horário de verão para o horário padrão, o relógio local se repete. Uma hora local dentro da janela repetida é ambígua porque ocorre duas vezes, uma no horário de verão e uma vez no horário padrão.
- Durante a transição do horário padrão para o horário de verão, o relógio local avança. Uma hora local dentro da janela ignorada é inválida porque não tem uma conversão UTC válida.
Se a hora local especificada for ambígua ou inválida, a função a tratará como horário de verão e aplicará o viés de horário de verão. Os aplicativos que exigem continuidade ou precisão devem evitar essa função e usar o tempo UTC.
Requirements
| Requirement | Value |
|---|---|
| Cliente mínimo suportado | Windows XP [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo compatível | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| da Plataforma de Destino |
Windows |
| Header | timezoneapi.h (inclua Windows.h) |
| Library | Kernel32.lib |
| de DLL | Kernel32.dll |