GetTimeZoneInformation
The GetTimeZoneInformation
function retrieves the current time-zone parameters. These parameters control
the translations between Coordinated Universal Time (UTC) and local time.
DWORD GetTimeZoneInformation(
|
LPTIME_ZONE_INFORMATION lpTimeZoneInformation |
// address of
time-zone settings |
|
); |
|
Parameters
lpTimeZoneInformation
Points 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 |
Meaning |
|
TIME_ZONE_ID_UNKNOWN |
The
operating system cannot determine the current time zone. This is usually
because a previous call to the SetTimeZoneInformation function supplied only
the bias (and no transition dates). |
|
TIME_ZONE_ID_STANDARD |
The
operating system is operating in the range covered by the StandardDate
member of the structure pointed to by the lpTimeZoneInformation
parameter. |
|
TIME_ZONE_ID_DAYLIGHT |
The
operating system is operating in the range covered by the DaylightDate
member of the structure pointed to by the lpTimeZoneInformation
parameter. |
If the
function fails, the return value is 0xFFFFFFFF. To get extended error
information, call GetLastError.
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