GetTimeZoneInformation (Windows CE 5.0)
This function retrieves the current time-zone parameters. These parameters control the translations between UTC and local time.
DWORDGetTimeZoneInformation(LPTIME_ZONE_INFORMATIONlpTimeZoneInformation );
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:
| Value | Description |
|---|---|
| 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_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 DaylightDatemember of the TIME_ZONE_INFORMATION structure. |
If the function fails, the return value is TIME_ZONE_ID_UNKNOWN. 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
OS Versions: Windows CE 1.0 and later.
Header: Winbase.h.
Link Library: Coredll.lib.
See Also
Time Functions | SetTimeZoneInformation | TIME_ZONE_INFORMATION | Timer Driver Reference
Send Feedback on this topic to the authors