# Titanium.Calendar.RecurrenceRule
An object that is used to describe the recurrence pattern for a recurring event.
# Overview
On Android there is no option to have multiple recurrence rules set for the same event. Android always uses only the first element in the array passed to Titanium.Calendar.Event.recurrenceRules.
In case of having Titanium.Calendar.RecurrenceRule.daysOfTheWeek and Titanium.Calendar.RecurrenceRule.daysOfTheWeek for an event with a recurrence rule of type Titanium.Calendar.RECURRENCEFREQUENCY_MONTHLY only [daysOfTheWeek] will be used.
# Properties
# daysOfTheMonth READONLY
The days of the month that the event occurs, as an array of number objects. Values can be from 1 to 31 and from -1 to -31. This parameter is only valid for recurrence rules of type RECURRENCEFREQUENCY_MONTHLY.
# daysOfTheWeek READONLY
The days of the week that the event occurs, as an array of objects daysOfWeek
and Week
.
On Android daysOfTheWeek is not valid for recurrence rules of type RECURRENCEFREQUENCY_YEARLY.
# daysOfTheYear READONLY
The days of the year that the event occurs, as an array of number objects. Values can be from 1 to 366 and from -1 to -366. This parameter is only valid for recurrence rules of type RECURRENCEFREQUENCY_YEARLY.
# end READONLY
End of a recurrence rule.
The recurrence end can be specified by a date (date-based) or by a maximum count
of occurrences (count-based). An event which is set to never end should not
have its recurrenceEnd set. Either
endDateor
occurrenceCount` property will be
present.
# frequency READONLY
Frequency of the recurrence rule.
# interval READONLY
The interval between instances of this recurrence. For example, a weekly recurrence rule with an interval of 2 occurs every other week. Must be greater than 0.
Default: 1
# monthsOfTheYear READONLY
The months of the year that the event occurs, as an array of Number objects. Values can be from 1 to 12. This parameter is only valid for recurrence rules of type RECURRENCEFREQUENCY_YEARLY.
# setPositions READONLY
An array of ordinal numbers that filters which recurrences to include in the
recurrence rule's frequency. For example, a yearly recurrence rule that has a
daysOfTheWeek value that specifies
Monday through Friday, and a setPositions
array containing 2 and -1, occurs only
on the second weekday and last weekday of every year.
# weeksOfTheYear READONLY
The weeks of the year that the event occurs, as an array of number objects. Values can be from 1 to 53 and from -1 to -53. This parameter is only valid for recurrence rules of type RECURRENCEFREQUENCY_YEARLY.