ITimeZone

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The ITimeZone interface provides read-only access to standard and daylight savings time zone information. You can create a time zone object by calling IPOutlookApp::GetTimeZoneFromIndex.

Methods in Vtable Order

• IUnknown methods
• IDispatch methods

ITimeZone methods	Description
ITimeZone::get_Bias	Gets the current bias, in minutes, for local time translation on this computer.
ITimeZone::get_SupportsDST	Determines whether a time zone supports daylight-saving time.
ITimeZone::get_IsStandardAbsoluteDate	Gets whether StandardDate is an absolute or relative date.
ITimeZone::get_IsDaylightAbsoluteDate	Determines whether DaylightDate is absolute or relative.
ITimeZone::get_StandardBias	Gets the offset in minutes added to a time zone when it is in standard time.
ITimeZone::get_StandardName	Gets the name of a time zone when standard time is in effect.
ITimeZone::get_StandardDate	Determines when a time zone enters standard time.
ITimeZone::get_StandardDayOfWeekMask	Gets the day of the week daylight-saving time starts.
ITimeZone::get_StandardInstance	Gets the week of the month (one to five) standard time starts.
ITimeZone::get_StandardMonthOfYear	Gets the month standard time starts.
ITimeZone::get_DaylightBias	Gets the offset in minutes added to the bias when the time zone is in daylight-saving time.
ITimeZone::get_DaylightName	Gets the name of this time zone when daylight-saving time is in effect.
ITimeZone::get_DaylightDate	Gets the date that a time zone enters daylight-saving time.
ITimeZone::get_DaylightDayOfWeekMask	Gets the day of the week that daylight-saving time starts.
ITimeZone::get_DaylightInstance	Gets the week of the month (from one to five) daylight-saving time starts.
ITimeZone::get_DaylightMonthOfYear	Gets the month of the year daylight-saving time starts.
ITimeZone::get_Application	Gets the main Outlook Mobile IPOutlookApp object.

Remarks

If a time zone does not support daylight-saving time (SupportsDST is FALSE), all subsequent values in the table are undefined.

The change between standard time and daylight-saving time is absolute if it falls on a particular date (such as April 5), and relative if it falls on a particular day (such as the first Sunday in April). The method used to find the times and dates of the changes depends on whether IsStandardAbsoluteDateandIsDaylightAbsoluteDate are TRUE or FALSE.

If IsStandardAbsoluteDate or IsDaylightAbsoluteDate is TRUE, then the date is absolute.

• To find when a time zone changes from standard time to daylight-saving time, get DaylightDate and discard the year value.
• To find when a time zone changes from daylight-saving time to standard time, get StandardDate and discard the year value.

If IsStandardAbsoluteDate or IsDaylightAbsoluteDate is FALSE, then the date is relative.

• To find the day a time zone changes from standard time to daylight-saving time, get DaylightDayOfWeekMask for the day, DaylightInstance for the week, and DaylightMonthOfYearfor the month. To find the time for the change, get DaylightDate and discard everything but the hours, minutes, and seconds.
• To find the day a time zone changes from daylight-saving time to standard time, get StandardDayOfWeekMask for the day, StandardInstance for the week, and StandardMonthOfYearfor the month. To find the time for the change, get StandardDate and discard everything but the hours, minutes, and seconds.

Requirements

Header	pimstore.h
Library	Pimstore.lib
Windows Embedded CE	Windows CE 2.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Pocket Outlook Object Model Interfaces

Other Resources

Pocket Outlook Object Model Enumerations