docs-v2/content/v2.0/reference/flux/stdlib/experimental/subduration.md

title	description	menu	weight	related
experimental.subDuration() function	The `experimental.subDuration()` function subtracts a duration from a time value and returns a the resulting time value.	v2_0_ref name parent experimental.subDuration Experimental	201	/v2.0/reference/flux/stdlib/experimental/addduration/

The experimental.subDuration() function subtracts a duration from a time value and returns the resulting time value.

Function type: Transformation

{{% warn %}} The experimental.subDuration() function is subject to change at any time. By using this function, you accept the risks of experimental functions.

This specific function will be removed once duration vectors are implemented. See influxdata/flux#413. {{% /warn %}}

import "experimental"

experimental.subDuration(
  d: 12h,
  from: now(),
)

Parameters

d

The duration to subtract.

Data type: Duration

from

The time to subtract the duration from.

Data type: Time

Examples

Subtract six hours from a timestamp

import "experimental"

experimental.subDuration(
  d: 6h,
  from: 2019-09-16T12:00:00Z,
)

// Returns 2019-09-16T06:00:00.000000000Z