Share via

2.1.3.1.1.20.8.1 Parameter: TZID

  • Article

RFC Reference: [RFC2445] section 4.2.19

Number of Instances Allowed: 0, 1

Format: Text ([RFC2445] section 4.3.11)

Brief Description: In conjunction with a matching VTIMEZONE, specifies the time zone of a Date-Time property provided in local time.

Importing to Calendar objects

If this appointment is recurring, and if there is a TZID parameter, and if neither PidLidTimeZoneStruct nor PidLidTimeZoneDescription has been imported from DTSTART (section 2.1.3.1.1.20.10), then PidLidTimeZoneStruct MUST be imported from the VTIMEZONE referenced by the TZID parameter,  PidLidTimeZoneDescription MUST be imported from the TZID parameter, and PidLidAppointmentTimeZoneDefinitionRecur SHOULD<132> be imported from the VTIMEZONE referenced by the TZID parameter. Otherwise, this parameter SHOULD be ignored.

Furthermore, PidLidAppointmentTimeZoneDefinitionEndDisplay SHOULD<133> be imported from the VTIMEZONE referenced by the TZID parameter.

Refer to [RFC2445] section 4.2.19 for additional details on the TZID parameter.

Exporting from Calendar objects

If this is a recurring non-all-day appointment, then the DTEND property MUST be specified as a local time. It MUST be accompanied by a TZID parameter that is equal to the TZID property of the VTIMEZONE described by PidLidAppointmentTimeZoneDefinitionRecur<134> or the combination of PidLidTimeZoneDescription and PidLidTimeZoneStruct.

If this is a non-recurring non-all-day appointment and if PidLidAppointmentTimeZoneDefinitionEndDisplay is set, then the DTEND property SHOULD<135> be specified as a local time. It MUST be accompanied by a TZID parameter that is equal to the TZID property of the VTIMEZONE described by PidLidAppointmentTimeZoneDefinitionEndDisplay.