GetTimeZoneInformation function (timezoneapi.h)

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

To support boundaries for daylight saving time that change from year to year, use the GetDynamicTimeZoneInformation or GetTimeZoneInformationForYear function.

DWORD GetTimeZoneInformation(
  [out] LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

[out] lpTimeZoneInformation

A pointer to a TIME_ZONE_INFORMATION structure to receive the current settings.

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

If the function fails for other reasons, such as an out of memory error, it returns TIME_ZONE_ID_INVALID. To get extended error information, call GetLastError.

All translations between UTC time and local time are based on the following formula:

UTC = local time + bias

The bias is the difference, in minutes, between UTC time and local time.

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

For an example, see SetTimeZoneInformation.

GetDynamicTimeZoneInformation

GetTimeZoneInformationForYear

Local Time

SetTimeZoneInformation

TIME_ZONE_INFORMATION

Time Functions