RecurrenceExceptionDates Property

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

Syntax

 caldav.getRecurrenceExceptionDates([callback])
 caldav.setRecurrenceExceptionDates( recurrenceExceptionDates, [callback])

Default Value

""

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for the getRecurrenceExceptionDates([callback]) method is defined as:

function(err, data){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'data' is the value returned by the method.

The callback for the setRecurrenceExceptionDates([callback]) method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

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

If the RecurrenceExceptionDates and RecurrenceExceptionRule 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 StartDate property along with the RecurrenceRule, RecurrenceDates, RecurrenceExceptionRule, and RecurrenceExceptionDates properties contained within the recurring event. The StartDate 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 RecurrenceRule and RecurrenceDates properties, and then excluding any start DATE-TIME values specified by the RecurrenceExceptionRule or RecurrenceExceptionDates properties. This implies that DATE-TIME values specified by the RecurrenceExceptionRule and RecurrenceExceptionDates properties take precedence over those specified by inclusion properties (i.e., RecurrenceDates and RecurrenceRule). When duplicate instances are generated by the recurrence RecurrenceRule and RecurrenceDates 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.

Data Type

String