<!--
{
  "availability" : [
    "watchOS: 2.0.0 - 27.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "ClockKit",
  "identifier" : "/documentation/ClockKit/CLKComplicationDataSource/getCurrentTimelineEntry(for:withHandler:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "ClockKit"
    ],
    "preciseIdentifier" : "c:objc(pl)CLKComplicationDataSource(im)getCurrentTimelineEntryForComplication:withHandler:"
  },
  "title" : "getCurrentTimelineEntry(for:withHandler:)"
}
-->

# getCurrentTimelineEntry(for:withHandler:)

Retrieves the timeline entry that you want to display now.

```
func getCurrentTimelineEntry(for complication: CLKComplication, withHandler handler: @escaping (CLKComplicationTimelineEntry?) -> Void)
```

## Parameters

`complication`

The complication tied to the request. Use the complication family information in this object to determine which set of templates are valid.

`handler`

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

- `updateInterval`: The [`CLKComplicationTimelineEntry`](/documentation/ClockKit/CLKComplicationTimelineEntry) object to display right now.

## Discussion

Your implementation of this method must create a timeline entry with the data to display right now. Assign a date to your timeline entry that reflects the current time or a time before the current time. If your complication supports past timeline entries, the entry you return from this method must come after all past entries that you provide using the [`getTimelineEntries(for:before:limit:withHandler:)`](/documentation/ClockKit/CLKComplicationDataSource/getTimelineEntries(for:before:limit:withHandler:)) method.

---

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)