2.1.3.1.1.19 Component: VTIMEZONE
RFC Reference: [RFC2445] section 4.6.5
Number of Instances Allowed: 0+<43>
Brief Description: Specifies any time zones referenced by TZID parameters.
Importing to Calendar objects
Since TZIDs can be referenced by many properties in the root component, VTIMEZONEs MUST be used to resolve all local times in the iCalendar file, even if the TZID reference occurs before the VTIMEZONE definition. This section discusses how to import a VTIMEZONE into a PidLidTimeZoneStruct structure ([MS-OXOCAL] section 2.2.1.39).
|
Field of the PidLidTimeZoneStruct structure |
Value |
|---|---|
|
lBias |
See section 2.1.3.1.1.19.2.5 |
|
lStandardBias |
Set to 0x00000000 |
|
lDaylightBias |
See section 2.1.3.1.1.19.3.5 |
|
stStandardDate |
See sections 2.1.3.1.1.19.2.1 and 2.1.3.1.1.19.2.2 |
|
stDaylightDate |
See sections 2.1.3.1.1.19.3.1 and 2.1.3.1.1.19.3.2 |
|
wStandardYear |
Set to the wYear field of stStandardDate |
|
wDaylightYear |
Set to the wYear field of stDaylightDate |
If this VTIMEZONE is imported as PidLidAppointmentTimeZoneDefinitionRecur ([MS-OXPROPS] section 2.33), PidLidAppointmentTimeZoneDefinitionStartDisplay ([MS-OXPROPS] section 2.34), and/or PidLidAppointmentTimeZoneDefinitionEndDisplay ([MS-OXPROPS] section 2.32),<44> then the following table specifies the contents of the resulting BLOB (the structure of this BLOB is specified in [MS-OXOCAL]). See section 2.1.3.1.1.20.8.1 and section 2.1.3.1.1.20.10.1 for more information.
|
Field of the BLOB |
Value |
|---|---|
|
Major Version |
Constant specified by [MS-OXOCAL] |
|
Minor Version |
Constant specified by [MS-OXOCAL] |
|
cbHeader |
Set to (0x0006 + 0x0002 * cchKeyName) |
|
Reserved |
Constant specified by [MS-OXOCAL] |
|
cchKeyName |
Set to the number of characters in KeyName |
|
KeyName |
See section 2.1.3.1.1.19.1 |
|
cRules |
Set to the number of TZRule structures (as specified in [MS-OXOCAL] section 2.2.1.41.1) in the TZRules field. This value is equal to the number of time zone rules generated by parsing the STANDARD (section 2.1.3.1.1.19.2) and DAYLIGHT (section 2.1.3.1.1.19.3) subcomponents. |
|
TZRules |
An array of TZRule structures as specified in the following table. |
The following table specifies the contents of each TZRule structure in the TZRules field.
|
TZRule structure field |
Value |
|---|---|
|
Major Version |
Constant specified by [MS-OXOCAL] |
|
Minor Version |
Constant specified by [MS-OXOCAL] |
|
Reserved |
Constant specified by [MS-OXOCAL] |
|
TZRule flags |
Set to 0x0002 for PidLidAppointmentTimeZoneDefinitionStartDisplay and PidLidAppointmentTimeZoneDefinitionEndDisplay. Set to 0x0003 for PidLidAppointmentTimeZoneDefinitionRecur. |
|
wYear |
For the first TZRule structure in the array, this field SHOULD be set to 0x0641 but MAY<45> be set to 0x0001. For subsequent TZRule structures, this field MUST be set to the year that corresponds to the time zone rule. |
|
X |
Constant specified by [MS-OXOCAL] |
|
lBias |
Import the same as the lBias field of a PidLidTimeZoneStruct structure |
|
lStandardBias |
Import the same as the lStandardBias field of a PidLidTimeZoneStruct structure |
|
lDaylightBias |
Import the same as the lDaylightBias field of a PidLidTimeZoneStruct structure |
|
stStandardDate |
Import the same as the stStandardDate field of a PidLidTimeZoneStruct structure |
|
stDaylightDate |
Import the same as the stDaylightDate field of a PidLidTimeZoneStruct structure |
Exporting from Calendar objects
A VTIMEZONE component MUST be declared for each unique value of any TZID parameters in the iCalendar. Note that the comparison used to match TZID parameters to VTIMEZONE components SHOULD<46> be case-insensitive.
If exporting a VTIMEZONE from a PidLidAppointmentTimeZoneDefinitionRecur, PidLidAppointmentTimeZoneDefinitionStartDisplay, or PidLidAppointmentTimeZoneDefinitionEndDisplay, the lBias, lStandardBias, lDaylightBias, stStandardDate, and stDaylightDate subfields of the TZRule entry with the TZRULE_FLAG_EFFECTIVE_TZREG (0x0002) bit set in the TZRule flags field MUST be exported as a PidLidTimeZoneStruct structure as specified in the following subsections.<47>