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

# CLKTimeTextProvider

A formatted time value.

```
class CLKTimeTextProvider
```

## Overview

This provider supports time values in either the 24-hour or 12-hour format and takes into account the user’s region and locale settings. As needed, the provider automatically shortens the string to fit the available space.

When formatting the time, the time text provider drops the morning/evening indicator if it can’t fit the entire time value. For example, a provider configured to display the time 10:09AM in the English-US locale would remove elements as follows until it encountered a string that fit the available space:

- `10:09AM`
- `10:09`

## Topics

### Creating a Text Provider

[`init(date:)`](/documentation/ClockKit/CLKTimeTextProvider/init(date:))

Creates and returns a text provider for displaying the specified time.

[`initWithDate:`](/documentation/ClockKit/CLKTimeTextProvider/initWithDate:)

Creates and returns a text provider for displaying the specified time.

[`init(date:timeZone:)`](/documentation/ClockKit/CLKTimeTextProvider/init(date:timeZone:))

Creates and returns a text provider for displaying the specified time.

[`initWithDate:timeZone:`](/documentation/ClockKit/CLKTimeTextProvider/initWithDate:timeZone:)

Creates and returns a text provider for displaying the specified time.

### Getting the Time Information

[`date`](/documentation/ClockKit/CLKTimeTextProvider/date)

The date object containing the time value.

[`timeZone`](/documentation/ClockKit/CLKTimeTextProvider/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)