A formatted string that conveys the difference in time between the current date and a date that you specify.
- watchOS 2.0+
You use a relative date text provider to implement timers or other relative time values in an efficient way. Instead of using multiple timeline entries to replicate a countdown timer, create a single timeline entry with a relative date text provider. When the user views the clock face, ClockKit automatically updates the relative time value in your complication, providing up-to-date time information.
When creating the formatted string, the relative date text provider creates the longest string that fits in the given space. It includes as many of the requested date elements as it can, but may truncate elements or use abbreviations as needed. The formatted string takes into account the user’s region and locale settings.
Date Format Options
When creating a
CLKRelative object, you must specify which calendar units you want included in the resulting date. Only the following calendar units are supported:
All other calendar units are ignored.
The format of the relative time value is dependent on the date style you choose when creating the text provider. For a list of possible styles and examples of each, see