This function retrieves the current time-zone parameters. These parameters control the translations between Coordinated Universal Time (UTC) and local time.
At a Glance
| Header file: | Winbase.h |
| Windows CE versions: | 1.0 and later |
Syntax
DWORD GetTimeZoneInformation(
LPTIME_ZONE_INFORMATION lpTimeZoneInformation );
Parameters
lpTimeZoneInformation
[out] Pointer 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:
TIME_ZONE_ID_UNKNOWN
The system cannot determine the current time zone. This error is also returned if you call the SetTimeZoneInformation function and supply the bias values but no transition dates. This value is returned if daylight savings time is not used in the current time zone, because there are no transition dates.
TIME_ZONE_ID_STANDARD
The system is operating in the range covered by the StandardDate member of the TIME_ZONE_INFORMATION structure.
TIME_ZONE_ID_DAYLIGHT
The system is operating in the range covered by the DaylightDate member of the TIME_ZONE_INFORMATION structure.
If the function fails, the return value is TIME_ZONE_ID_INVALID. To get extended error information, call GetLastError.
Prior to Windows version 2.10, a known problem caused this function to always return TIME_ZONE_ID_UNKNOWN.
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