GetTimeZoneInformation
A version of this page is also available for
4/8/2010
This function retrieves the current time-zone parameters. These parameters control the translations between UTC and local time.
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 Value
The following table shows possible values that indicate success.
| Value | Description |
|---|---|
TIME_ZONE_ID_DAYLIGHT |
The system is operating in the range covered by the DaylightDatemember of the TIME_ZONE_INFORMATION structure. |
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_UNKNOWN |
The system cannot determine the current time zone. If daylight saving time is not used in the current time zone, this value is returned because there are no transition dates. |
TIME_ZONE_ID_UNKNOWN indicates failure. To get extended error information, call GetLastError.
Remarks
All translations between UTC and local time are based on the following formula:
UTC = local time + bias
The bias is the difference, in minutes, between UTC and local time. If a call to SetTimeZoneInformation supplies a bias value but no transition date, GetTimeZoneInformation will return either TIME_ZONE_ID_STANDARD or TIME_ZONE_ID_DAYLIGHT.
Requirements
| Header | winbase.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 1.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
Time Functions
SetTimeZoneInformation
TIME_ZONE_INFORMATION