---
title: dispatch_time
framework: dispatch
role: symbol
role_heading: Function
path: dispatch/dispatch_time
---

# dispatch_time

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

## Declaration

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

## Parameters

- `when`: The doc://com.apple.dispatch/documentation/Dispatch/dispatch_function_t value to use as the basis for a new value. Pass doc://com.apple.dispatch/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

Return Value A new dispatch_time_t.

## Discussion

Discussion The default clock is based on mach_absolute_time.

## See Also

### Time Constructs

- [dispatch_walltime](dispatch/dispatch_walltime.md)
- [dispatch_time_t](dispatch/dispatch_time_t.md)
- [DISPATCH_WALLTIME_NOW](dispatch/dispatch_walltime_now.md)
- [Wall Time Constants](dispatch/2963138-wall-time-constants.md)