Compartir a través de

Función TzSpecificLocalTimeToSystemTime (timezoneapi.h)

Convierte la hora local especificada en la hora correspondiente en hora universal coordinada (UTC).

Syntax

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

Parámetros

[in, optional] lpTimeZoneInformation

Puntero a una estructura de TIME_ZONE_INFORMATION que especifica la zona horaria de la hora especificada en lpLocalTime.

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

TzSpecificLocalTimeToSystemTime tiene en cuenta si el horario de verano (DST) está en vigor para que se convierta la hora local.

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.
  • 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 la hora local especificada es ambigua o no es válida, la función la trata como horario de verano y aplica el sesgo del horario de verano. 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 XP [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo admitido Windows Server 2003 [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

Consulte también

GetSystemTime

GetTimeZoneInformation

Hora local

SYSTEMTIME

SystemTimeToTzSpecificLocalTime

TIME_ZONE_INFORMATION

Funciones de hora

  • Last updated on