recurrence_exception_dates Property

Defines the list of DATE-TIME exceptions to the recurrence set.

Syntax

def get_recurrence_exception_dates() -> str: ...
def set_recurrence_exception_dates(value: str) -> None: ...

recurrence_exception_dates = property(get_recurrence_exception_dates, set_recurrence_exception_dates)

Default Value

""

Remarks

Defines the list of DATE-TIME exceptions to the recurrence set.

If the recurrence_exception_dates and recurrence_exception_rule are specified, they are used in computing the recurrence set. The recurrence set is the complete set of recurrence instances for a calendar component. The recurrence set is generated by considering the initial start_date property along with the recurrence_rule, recurrence_dates, recurrence_exception_rule, and recurrence_exception_dates properties contained within the recurring event. The start_date property defines the first instance in the recurrence set. The starting date SHOULD match the pattern of the recurrence rule, if specified. The recurrence set generated with a start date that doesn't match the pattern of the rule is undefined. The final recurrence set is generated by gathering all of the start DATE-TIME values generated by any of the specified recurrence_rule and recurrence_dates properties, and then excluding any start DATE-TIME values specified by the recurrence_exception_rule or recurrence_exception_dates properties. This implies that DATE-TIME values specified by the recurrence_exception_rule and recurrence_exception_dates properties take precedence over those specified by inclusion properties (i.e., recurrence_dates and recurrence_rule). When duplicate instances are generated by the recurrence recurrence_rule and recurrence_dates properties, only one recurrence is considered. Duplicate instances are ignored.

The date/time format is "YYYYMMDDThhmmss", where "T" indicates the break between date and time. You may also append a 1-character alpha code for the timezone. For instance, "20100104T123456Z" indicates January 4th, 2010 at 12:34:56 PM UTC.

This property is filled after retrieving a calendar event, and is also used to create an event to put on the server. However, when requesting a report the contents of this property will only be valid inside the CalDAV EventDetails event.