--- title: experimental.subDuration() function description: > `experimental.subDuration()` subtracts a duration from a time value and returns the resulting time value. menu: flux_v0_ref: name: experimental.subDuration parent: experimental identifier: experimental/subDuration weight: 101 flux/v0/tags: [date/time] introduced: 0.39.0 deprecated: 0.162.0 --- `experimental.subDuration()` subtracts a duration from a time value and returns the resulting time value. {{% warn %}} #### Deprecated `experimental.subDuration()` is deprecated in favor of [`date.sub()`](/flux/v0/stdlib/date/sub/). {{% /warn %}} ##### Function type signature ```js (d: duration, from: A, ?location: {zone: string, offset: duration}) => time where A: Timeable ``` {{% caption %}} For more information, see [Function type signatures](/flux/v0/function-type-signatures/). {{% /caption %}} ## Parameters ### from ({{< req >}}) Time to subtract the duration from. Use an absolute time or a relative duration. Durations are relative to `now()`. ### d ({{< req >}}) Duration to subtract. ### location Location to use for the time value. ## Examples - [Subtract six hours from a timestamp](#subtract-six-hours-from-a-timestamp) - [Subtract six hours from a relative duration](#subtract-six-hours-from-a-relative-duration) - [Subtract two days from one hour ago](#subtract-two-days-from-one-hour-ago) ### Subtract six hours from a timestamp ```js import "experimental" experimental.subDuration(from: 2019-09-16T12:00:00Z, d: 6h)// Returns 2019-09-16T06:00:00.000000000Z ``` ### Subtract six hours from a relative duration ```js import "experimental" option now = () => 2022-01-01T12:00:00Z experimental.subDuration(d: 6h, from: -3h)// Returns 2022-01-01T03:00:00.000000000Z ``` ### Subtract two days from one hour ago A time may be represented as either an explicit timestamp or as a relative time from the current `now` time. subDuration can support either type of value. ```js import "experimental" option now = () => 2021-12-10T16:27:40Z experimental.subDuration(from: -1h, d: 2d)// Returns 2021-12-08T15:27:40Z ```