<!--
{
  "availability" : [
    "iOS: 4.0.0 -",
    "iPadOS: 4.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.6.0 -",
    "tvOS: -",
    "visionOS: 1.0.0 -",
    "watchOS: 2.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Dispatch",
  "identifier" : "/documentation/Dispatch/dispatch_time",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Dispatch"
    ],
    "preciseIdentifier" : "c:@F@dispatch_time"
  },
  "title" : "dispatch_time"
}
-->

# dispatch_time

Creates a `dispatch_time_t` relative to the default clock or modifies an existing `dispatch_time_t`.

```
extern dispatch_time_t dispatch_time(dispatch_time_t when, int64_t delta);
```

## Parameters

`when`

The [`dispatch_function_t`](/documentation/Dispatch/dispatch_function_t) value to use as the basis for a new value. Pass [`DISPATCH_TIME_NOW`](/documentation/Dispatch/DISPATCH_TIME_NOW) to create a new time value relative to now.

`delta`

The number of nanoseconds to add to the time in the `when` parameter.

## Return Value

A new [`dispatch_time_t`](/documentation/Dispatch/dispatch_time_t).

## Discussion

The default clock is based on <doc://com.apple.documentation/documentation/kernel/1462446-mach_absolute_time>.

---

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)