---
title: "init(date:units:timeZone:)"
framework: clockkit
role: symbol
role_heading: Initializer
path: "clockkit/clkdatetextprovider/init(date:units:timezone:)"
---

# init(date:units:timeZone:)

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

## Declaration

```swift
convenience init(date: Date, units calendarUnits: NSCalendar.Unit, timeZone: TimeZone?)
```

## Parameters

- `date`: The date to display. This parameter must not be nil.
- `calendarUnits`: The units to include in the resulting date string. For a list of supported calendar units, see doc://com.apple.clockkit/documentation/ClockKit/CLKDateTextProvider#Date-Format-Options.
- `timeZone`: The time zone to use when formatting the date. If you specify nil, the text provider uses the time zone currently associated with the user.

## Return Value

Return Value A text provider initialized with the specified date and time zone information.

## Discussion

Discussion Date values are formatted according to the user’s current locale information.

## See Also

### Creating a Text Provider

- [init(date:units:)](clockkit/clkdatetextprovider/init(date:units:).md)