GetTimeZoneInformation

Windows Mobile 6.5
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.


DWORD GetTimeZoneInformation(
  LPTIME_ZONE_INFORMATION lpTimeZoneInformation
);

lpTimeZoneInformation

[out] Pointer to a TIME_ZONE_INFORMATION structure to receive the current time-zone parameters.

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.

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.

Headerwinbase.h
Librarycoredll.lib
Windows Embedded CEWindows CE 1.0 and later
Windows MobileWindows Mobile Version 5.0 and later

Community Additions

Show: