Edit

Share via


GetDynamicTimeZoneInformation function (timezoneapi.h)

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

See also

DYNAMIC_TIME_ZONE_INFORMATION

SetDynamicTimeZoneInformation

Time Functions