<!--
{
  "availability" : [
    "iOS: 10.0.0 -",
    "iPadOS: 10.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 11.0.0 -",
    "tvOS: 14.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 3.2.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SiriKit",
  "identifier" : "/documentation/Intents/INDateComponentsRange",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Intents"
    ],
    "preciseIdentifier" : "c:objc(cs)INDateComponentsRange"
  },
  "title" : "INDateComponentsRange"
}
-->

# INDateComponentsRange

A span of time.

```
class INDateComponentsRange
```

## Overview

Use an [`INDateComponentsRange`](/documentation/Intents/INDateComponentsRange) object to specify date- or time-related information when responding to an intent. For example, a ride service might use this object to specify possible pickup times for the user.

You create date components range objects when providing a response that includes a time span. Use this object to specify a range of times to include in the corresponding response. When displaying the date range information to the user, Siri or Maps formats the information appropriately.

## Topics

### Initializing a Date Components Range

[`init(start:end:)`](/documentation/Intents/INDateComponentsRange/init(start:end:))

Initializes the object using the specified start and end dates.

[`init(start:end:recurrenceRule:)`](/documentation/Intents/INDateComponentsRange/init(start:end:recurrenceRule:))

Initializes the date range to a repeating time period.

[`init(ekRecurrenceRule:)`](/documentation/Intents/INDateComponentsRange/init(ekRecurrenceRule:)-5p7kt)

Initializes the date range using the specified recurrence rule.

### Getting the Date Information

[`startDateComponents`](/documentation/Intents/INDateComponentsRange/startDateComponents)

The start date of the range.

[`endDateComponents`](/documentation/Intents/INDateComponentsRange/endDateComponents)

The end date of the range.

### Getting Recurring Date Information

[`recurrenceRule`](/documentation/Intents/INDateComponentsRange/recurrenceRule)

The rule for repeating the date range.

[`ekRecurrenceRule()`](/documentation/Intents/INDateComponentsRange/ekRecurrenceRule())

Returns an Event Kit recurrence rule that matches the available information.


---

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)