ITimeZone
The ITimeZone interface provides read-only access to standard and daylight savings time zone information. You create a time zone object by calling IPOutlookApp::GetTimeZoneFromIndex.
Methods in Vtable Order
| ITimeZone methods | Description |
|---|---|
| get_Bias | Gets the current bias, in minutes, for local time translation on this computer. |
| get_SupportsDST | Determines whether a time zone supports daylight-saving time. |
| get_IsStandardAbsoluteDate | Gets whether StandardDate is an absolute or relative date. |
| get_IsDaylightAbsoluteDate | Determines whether DaylightDate is absolute or relative. |
| get_StandardBias | Gets the offset in minutes added to a time zone when it is in standard time. |
| get_StandardName | Gets the name of a time zone when standard time is in effect. |
| get_StandardDate | Determines when a time zone enters standard time. |
| get_StandardDayOfWeekMask | Gets the day of the week daylight-saving time starts. |
| get_StandardInstance | Gets the week of the month (one to five) standard time starts. |
| get_StandardMonthOfYear | Gets the month standard time starts. |
| get_DaylightBias | Gets the offset in minutes added to the bias when the time zone is in daylight-saving time. |
| get_DaylightName | Gets the name of this time zone when daylight-saving time is in effect. |
| get_DaylightDate | Gets the date that a time zone enters daylight-saving time. |
| get_DaylightDayOfWeekMask | Gets the day of the week that daylight-saving time starts. |
| get_DaylightInstance | Gets the week of the month (from one to five) daylight-saving time starts. |
| get_DaylightMonthOfYear | Gets the month of the year daylight-saving time starts. |
| get_Application | Gets the main Pocket Outlook 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 IsStandardAbsoluteDate and IsDaylightAbsoluteDate are TRUE or FALSE.
If IsStandardAbsoluteDate or IsDaylightAbsoluteDate is TRUE 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, 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 DaylightMonthOfYear for 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 StandardMonthOfYear **** for the month. To find the time for the change, get StandardDate and discard everything but the hours, minutes, and seconds.
Requirements
Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: pimstore.h
Library: pimstore.lib
See Also
Pocket Outlook Object Model API Interfaces
Pocket Outlook Object Model API Enumerations
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.