GetDynamicTimeZoneInformation function

Retrieves the current time zone and dynamic daylight saving time settings. These settings control the translations between Coordinated Universal Time (UTC) and local time.

Syntax

DWORD GetDynamicTimeZoneInformation(
  PDYNAMIC_TIME_ZONE_INFORMATION pTimeZoneInformation
);

Parameters

pTimeZoneInformation

A pointer to a DYNAMIC_TIME_ZONE_INFORMATION structure.

Return Value

If the function succeeds, it returns one of the following values.

Return code/value Description
TIME_ZONE_ID_UNKNOWN
0
Daylight saving time is not used in the current time zone, because there are no transition dates.
TIME_ZONE_ID_STANDARD
1
The system is operating in the range covered by the StandardDate member of the DYNAMIC_TIME_ZONE_INFORMATION structure.
TIME_ZONE_ID_DAYLIGHT
2
The system is operating in the range covered by the DaylightDate member of the DYNAMIC_TIME_ZONE_INFORMATION structure.
 

If the function fails, it returns TIME_ZONE_ID_INVALID. To get extended error information, call GetLastError.

Remarks

The StandardName and DaylightName members of the resultant DYNAMIC_TIME_ZONE_INFORMATION structure are localized according to the current user default UI language.

Requirements

   
Minimum supported client Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header timezoneapi.h (include Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See Also

DYNAMIC_TIME_ZONE_INFORMATION

SetDynamicTimeZoneInformation

Time Functions