# init(recurrenceWith:interval:daysOfTheWeek:daysOfTheMonth:monthsOfTheYear:weeksOfTheYear:daysOfTheYear:setPositions:end:) Initializes and returns a recurrence rule with a given frequency and additional scheduling information. ``` init(recurrenceWith type: EKRecurrenceFrequency, interval: Int, daysOfTheWeek days: [EKRecurrenceDayOfWeek]?, daysOfTheMonth monthDays: [NSNumber]?, monthsOfTheYear months: [NSNumber]?, weeksOfTheYear: [NSNumber]?, daysOfTheYear: [NSNumber]?, setPositions: [NSNumber]?, end: EKRecurrenceEnd?) ``` ## Parameters `type` The frequency of the recurrence rule. Can be daily, weekly, monthly, or yearly. `interval` 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`. `days` The days of the week that the event occurs, as an array of [`EKRecurrenceDayOfWeek`](/documentation/EventKit/EKRecurrenceDayOfWeek) objects. `monthDays` The days of the month that the event occurs, as an array of objects. Values can be from `1` to `31` and from `-1` to `-31`. This parameter is only valid for recurrence rules of type [`EKRecurrenceFrequency.monthly`](/documentation/EventKit/EKRecurrenceFrequency/monthly). `months` The months of the year that the event occurs, as an array of `NSNumber` objects. Values can be from `1` to `12`. This parameter is only valid for recurrence rules of type [`EKRecurrenceFrequency.yearly`](/documentation/EventKit/EKRecurrenceFrequency/yearly). `weeksOfTheYear` The weeks of the year that the event occurs, as an array of `NSNumber` objects. Values can be from `1` to `53` and from `-1` to `-53`. This parameter is only valid for recurrence rules of type [`EKRecurrenceFrequency.yearly`](/documentation/EventKit/EKRecurrenceFrequency/yearly). `daysOfTheYear` The days of the year that the event occurs, as an array of `NSNumber` objects. Values can be from `1` to `366` and from `-1` to `-366`. This parameter is only valid for recurrence rules of type [`EKRecurrenceFrequency.yearly`](/documentation/EventKit/EKRecurrenceFrequency/yearly). `setPositions` An array of ordinal numbers that filters which recurrences to include in the recurrence rule’s frequency. See [`setPositions`](/documentation/EventKit/EKRecurrenceRule/setPositions) for more information. `end` The end of the recurrence rule. ## Return Value The initialized recurrence rule, or `nil` if invalid values are provided. ## Discussion Negative values indicate counting backwards from the end of the recurrence rule’s frequency. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)