Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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