docs-v2/content/flux/v0.x/stdlib/experimental/addduration.md

title	description	aliases	menu	weight	flux/v0.x/tags	related	introduced	deprecated
experimental.addDuration() function	The `experimental.addDuration()` function adds a duration to a time value and returns the resulting time.	/influxdb/v2.0/reference/flux/stdlib/experimental/addduration/ /influxdb/cloud/reference/flux/stdlib/experimental/addduration/	flux_0_x_ref name parent experimental.addDuration experimental	302	date/time	/flux/v0.x/stdlib/experimental/subduration/	0.39.0	0.162.0

{{% warn %}} This function was promoted to the date package in Flux v0.162.0. This experimental version has been deprecated. {{% /warn %}}

The experimental.addDuration() function adds a duration to a time value and returns the resulting time value.

import "experimental"

experimental.addDuration(
    d: 12h,
    to: now(),
)

Parameters

d

The duration to add.

to

The time to add the duration to. Use an absolute time or a relative duration. Durations are relative to now().

Examples

Add six hours to a timestamp

import "experimental"

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

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

Add six hours to a relative duration

import "experimental"

option now = () => 2022-01-01T12:00:00Z

experimental.addDuration(d: 6h, to: 3h)

// Returns 2022-01-01T21:00:00.000000000Z