<!--
{
  "availability" : [
    "iOS: 8.0.0 -",
    "iPadOS: 8.0.0 -",
    "macCatalyst: 8.0.0 -",
    "tvOS: 10.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "HomeKit",
  "identifier" : "/documentation/HomeKit/HMTimerTrigger/recurrence",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "HomeKit"
    ],
    "preciseIdentifier" : "c:objc(cs)HMTimerTrigger(py)recurrence"
  },
  "title" : "recurrence"
}
-->

# recurrence

The interval on which to repeat firing the trigger.

```
var recurrence: DateComponents? { get }
```

## Discussion

This value may be `nil` if the trigger should not repeat.

The next fire date is calculated by adding the date components to the last fire date, as evaluated in the context of the trigger’s [`recurrenceCalendar`](/documentation/HomeKit/HMTimerTrigger/recurrenceCalendar). Depending on the calendar, some date components may result in an undefined next fire date.

The minimum recurrence interval is five minutes, and the most precision possible are whole minute values—you may not specify seconds in a recurrence interval. The maximum recurrence interval is five weeks.

---

Copyright &copy; 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)