GetTimeZoneInformation (Compact 2013)
3/28/2014
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 |
See Also
Reference
Time Functions
SetTimeZoneInformation
TIME_ZONE_INFORMATION