Compartir a través de

Función TzSpecificLocalTimeToSystemTimeEx (timezoneapi.h)

Convierte la hora local especificada, con la configuración dinámica del horario de verano (DST), a la hora correspondiente en hora universal coordinada (UTC).

Syntax

BOOL TzSpecificLocalTimeToSystemTimeEx(
  [in, optional] const DYNAMIC_TIME_ZONE_INFORMATION *lpTimeZoneInformation,
  [in]           const SYSTEMTIME                    *lpLocalTime,
  [out]          LPSYSTEMTIME                        lpUniversalTime
);

Parámetros

[in, optional] lpTimeZoneInformation

Puntero a una estructura de DYNAMIC_TIME_ZONE_INFORMATION que especifica la zona horaria y la configuración dinámica de DST.

Si lpTimeZoneInformation es NULL, la función usa la zona horaria activa actualmente.

[in] lpLocalTime

Puntero a una estructura SYSTEMTIME que especifica la hora local que se va a convertir. La función convierte esta hora a la hora UTC correspondiente.

[out] lpUniversalTime

Puntero a una estructura SYSTEMTIME que recibe la hora UTC.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero y la función establece los miembros de la estructura SYSTEMTIME a la que apunta lpUniversalTime a los valores adecuados.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

TzSpecificLocalTimeToSystemTimeEx tiene en cuenta si el DST está en vigor para la hora local que se va a convertir.

Importante

Las siguientes horas locales, cerca de las transiciones de DST, pueden ser ambiguas o no válidas y pueden dar lugar a un comportamiento inesperado (ya que no hay ningún resultado "correcto" garantizado).

  • Durante la transición del horario de verano a la hora estándar, el reloj local se repite. Una hora local dentro de la ventana repetida es ambigua porque se produce dos veces, una vez en horario de verano y una vez en el horario estándar. Si se especifica dicha hora local, esta función la trata como horario de verano y aplica el sesgo del horario de verano.
  • Durante la transición del horario estándar al horario de verano, el reloj local salta hacia delante. Una hora local dentro de la ventana omitida no es válida porque no tiene una conversión UTC válida. Si se especifica dicha hora local, la función la trata como hora estándar y aplica el sesgo de hora estándar.

Las aplicaciones que requieren continuidad o precisión deben evitar esta función y usar la hora UTC en su lugar.

Requisitos

Requirement Importancia
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de Windows
Header timezoneapi.h (incluya Windows.h)
Library Kernel32.lib
DLL de Kernel32.dll
  • Last updated on