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 WINAPI GetDynamicTimeZoneInformation(
  _Out_  PDYNAMIC_TIME_ZONE_INFORMATION pTimeZoneInformation
);

Parameters

pTimeZoneInformation [out]

A pointer to a DYNAMIC_TIME_ZONE_INFORMATION structure.

Return value

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

Return code/valueDescription
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.

Windows Phone 8: This API is supported.

Windows Phone 8.1: This API is supported.

Requirements

Minimum supported client

Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 [desktop apps | Windows Store apps]

Header

Winbase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

DYNAMIC_TIME_ZONE_INFORMATION
SetDynamicTimeZoneInformation
Time Functions

 

 

Community Additions

ADD
Show:
© 2014 Microsoft