---
title: "init(recurrenceWith:interval:daysOfTheWeek:daysOfTheMonth:monthsOfTheYear:weeksOfTheYear:daysOfTheYear:setPositions:end:)"
framework: eventkit
role: symbol
role_heading: Initializer
path: "eventkit/ekrecurrencerule/init(recurrencewith:interval:daysoftheweek:daysofthemonth:monthsoftheyear:weeksoftheyear:daysoftheyear:setpositions:end:)"
---

# init(recurrenceWith:interval:daysOfTheWeek:daysOfTheMonth:monthsOfTheYear:weeksOfTheYear:daysOfTheYear:setPositions:end:)

Initializes and returns a recurrence rule with a given frequency and additional scheduling information.

## Declaration

```swift
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 doc://com.apple.eventkit/documentation/EventKit/EKRecurrenceDayOfWeek objects.
- `monthDays`: The days of the month that the event occurs, as an array of doc://com.apple.documentation/documentation/Foundation/NSNumber objects. Values can be from 1 to 31 and from -1 to -31. This parameter is only valid for recurrence rules of type doc://com.apple.eventkit/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 doc://com.apple.eventkit/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 doc://com.apple.eventkit/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 doc://com.apple.eventkit/documentation/EventKit/EKRecurrenceFrequency/yearly.
- `setPositions`: An array of ordinal numbers that filters which recurrences to include in the recurrence rule’s frequency. See doc://com.apple.eventkit/documentation/EventKit/EKRecurrenceRule/setPositions for more information.
- `end`: The end of the recurrence rule.

## Mentioned in

Creating a recurring event

## Return Value

Return Value The initialized recurrence rule, or nil if invalid values are provided.

## Discussion

Discussion Negative values indicate counting backwards from the end of the recurrence rule’s frequency.