Instance Method


Retrieves the earliest date for which your complication is prepared to supply data.


optional func getTimelineStartDate(for complication: CLKComplication, withHandler handler: @escaping (Date?) -> Void)



The complication tied to the request.


The handler to execute with the start date. This block has no return value and takes the following parameter:


The start date for your data. For times before this date, WatchKit dims your data to indicate that the timeline does not continue. If you specify nil, ClockKit does not ask for any more past data.


Only implement this method if your app supports Time Travel on watchOS 4 or earlier.

Your implementation of this method must execute the block in the handler parameter and specify the earliest date for which you can supply timeline entries. If you do not support displaying past data using Time Travel, specify the current date.

If you do not implement this method, ClockKit does not attempt to retrieve timeline entries before the current entry.

See Also

Getting the Timeline Information

func getSupportedTimeTravelDirections(for: CLKComplication, withHandler: (CLKComplicationTimeTravelDirections) -> Void)

Determines whether your complication can provide timeline entries for the future or the past.


func getTimelineEndDate(for: CLKComplication, withHandler: (Date?) -> Void)

Retrieves the latest date for which your complication is prepared to supply data.