The GetTimeZoneInformation function retrieves the current time-zone parameters. These parameters control the translations between Coordinated Universal Time (UTC) and local time.
DWORD GetTimeZoneInformation(
| LPTIME_ZONE_INFORMATION lpTimeZoneInformation | // address of time-zone settings |
| ); |
Parameters
lpTimeZoneInformation
Points to a TIME_ZONE_INFORMATION structure to receive the current time-zone parameters.
Return Values
If the function succeeds, the return value is one of the following values:
| Value | Meaning |
| TIME_ZONE_ID_UNKNOWN | The operating system cannot determine the current time zone. This is usually because a previous call to the SetTimeZoneInformation function supplied only the bias (and no transition dates). |
| TIME_ZONE_ID_STANDARD | The operating system is operating in the range covered by the StandardDate member of the structure pointed to by the lpTimeZoneInformation parameter. |
| TIME_ZONE_ID_DAYLIGHT | The operating system is operating in the range covered by the DaylightDate member of the structure pointed to by the lpTimeZoneInformation parameter. |
If the function fails, the return value is 0xFFFFFFFF. To get extended error information, call GetLastError.
Remarks
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.
See Also