Instance Method


Called to get the next time at which to update your complication.


- (void)getNextRequestedUpdateDateWithHandler:(void (^)(NSDate *updateDate))handler;



The handler to execute with the next date at which to run your complication code. This block has no return value and takes the following parameter:


The date after which you would like your complication to run again. If you specify nil, ClockKit does not schedule a new update time for your complication. You can still trigger updates manually.


Your implementation of this method must execute the block in the handler parameter and specify an appropriate date. Specify a date as far into the future as you can manage for your complications. ClockKit wakes up your complication at some point after the specified date to request new data. The exact time at which your complication runs is not guaranteed.

If your complication data changes before the specified update date, you can invalidate your complication data using the CLKComplicationServer object.

If you do not implement this method, ClockKit does not schedule your complication for another update. You must trigger updates to your complication’s data manually by extending or reloading your timeline.

See Also

Getting the Timeline Information

- getSupportedTimeTravelDirectionsForComplication:withHandler:

Called to retrieve the time travel directions supported by your complication.


- getTimelineStartDateForComplication:withHandler:

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

- getTimelineEndDateForComplication:withHandler:

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