GetDynamicTimeZoneInformation function (timezoneapi.h)

Article
02/22/2024

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(
  [out] PDYNAMIC_TIME_ZONE_INFORMATION pTimeZoneInformation
);

Parameters

[out] 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

Requirement	Value
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