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. |
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).
- 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 |