<!--
{
  "availability" : [
    "watchOS: 2.0.0 - 27.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "ClockKit",
  "identifier" : "/documentation/ClockKit/CLKTimeIntervalTextProvider",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "ClockKit"
    ],
    "preciseIdentifier" : "c:objc(cs)CLKTimeIntervalTextProvider"
  },
  "title" : "CLKTimeIntervalTextProvider"
}
-->

# CLKTimeIntervalTextProvider

A formatted time range.

```
class CLKTimeIntervalTextProvider
```

## Overview

This provider creates strings like “10:15–11:15AM” where the time range may span hours, days, or some larger time interval. The text provider takes into account the user’s region and locale settings.

Time interval strings are more appropriate in complication families where there’s sufficient space to draw the full time range, such as the modular large and utilitarian large families. In families where space is more limited, the provider may display only the start date of the time range.

When formatting the time interval, the time text provider drops the morning/evening indicator of the start time when it’s the same as the end time. Time intervals that are more than 24 hours are displayed as a range of days. The following are some examples of formatted time intervals:

- `9:30AM - 3:30PM`
- `9:30 - 10:30AM`
- `Jan 1 - Jan 7`
- `1/1 - 1/7`

## Topics

### Creating the Text Provider

[`init(start:end:)`](/documentation/ClockKit/CLKTimeIntervalTextProvider/init(start:end:))

Creates and returns a text provider with the specified start and end dates.

[`initWithStartDate:endDate:`](/documentation/ClockKit/CLKTimeIntervalTextProvider/initWithStartDate:endDate:)

Creates and returns a text provider with the specified start and end dates.

[`init(start:end:timeZone:)`](/documentation/ClockKit/CLKTimeIntervalTextProvider/init(start:end:timeZone:))

Creates and returns a text provider with the specified dates and time zone information.

[`initWithStartDate:endDate:timeZone:`](/documentation/ClockKit/CLKTimeIntervalTextProvider/initWithStartDate:endDate:timeZone:)

Creates and returns a text provider with the specified dates and time zone information.

### Getting the Time Information

[`startDate`](/documentation/ClockKit/CLKTimeIntervalTextProvider/startDate)

The start date for the time interval.

[`endDate`](/documentation/ClockKit/CLKTimeIntervalTextProvider/endDate)

The end date for the time interval.

[`timeZone`](/documentation/ClockKit/CLKTimeIntervalTextProvider/timeZone)

The time zone used to format time values.


---

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)