Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure specifies information specific to the time zone.

Syntax

typedef struct _TIME_ZONE_INFORMATION {
  LONG 
Bias;
  WCHAR 
StandardName[32];
  SYSTEMTIME 
StandardDate;
  LONG 
StandardBias;
  WCHAR 
DaylightName[32];
  SYSTEMTIME 
DaylightDate;
  LONG 
DaylightBias;
} TIME_ZONE_INFORMATION;

Members

Bias

Specifies the current bias, in minutes, for local time translation on this computer.

The bias is the difference, in minutes, between UTC and local time.

All translations between UTC and local time are based on the following formula.

Copy Code
UTC = local time + bias

This member is required.

StandardName

Specifies a null-terminated string associated with standard time on this OS. For example, this member could contain EST to indicate Eastern Standard Time.

This string is not used by the OS, so anything stored there by using the SetTimeZoneInformationfunction is returned unchanged by the GetTimeZoneInformationfunction.

This string can be empty.

StandardDate

Specifies a SYSTEMTIMEstructure that contains a date and local time when the transition from daylight time to standard time occurs on this OS.

If this date is not specified, the wMonthmember in the SYSTEMTIMEstructure must be zero.

If this date is specified, the DaylightDatevalue in the TIME_ZONE_INFORMATIONstructure must also be specified.

This member supports one date format:

  • Day-in-month format is specified by setting the wYearmember to zero, setting the wDayOfWeekmember to an appropriate weekday, and using a wDayvalue in the range 1 through 5 to select the correct day in the month. Using this notation, the first Sunday in April can be specified, as can the last Thursday in October (5 is equal to the last).

StandardBias

Specifies a bias value to be used during local time translations that occur during standard time.

This value is added to the value of the Biasmember to form the bias used during standard time. In most time zones, the value of this member is zero.

DaylightName

Specifies a null-terminated string associated with daylight time on this OS. For example, this member could contain PDT to indicate Pacific Daylight Time.

This string is not used by the OS, so anything stored there by using the SetTimeZoneInformationfunction is returned unchanged by the GetTimeZoneInformationfunction.

This string can be empty.

DaylightDate

Specifies a SYSTEMTIMEstructure that contains a date and local time when the transition from standard time to daylight time occurs on this OS.

If this date is not specified, the wMonthmember in the SYSTEMTIMEstructure must be zero. If this date is specified, the StandardDatevalue in the TIME_ZONE_INFORMATIONstructure must also be specified.

This member supports the day-in-month time format described for the StandardDatemember.

DaylightBias

Specifies a bias value to be used during local time translations that occur during daylight time.

This member is ignored if a value for the DaylightDatemember is not supplied.

This value is added to the value of the Biasmember to form the bias used during daylight time.

In most time zones, the value of this member is –60.

Requirements

Header winbase.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also