Documentation

duration() function

duration() converts a value to a duration type.

duration() treats integers and unsigned integers as nanoseconds. For a string to be converted to a duration type, the string must use duration literal representation.

Function type signature
(v: A) => duration
For more information, see Function type signatures.

Parameters

v

(Required) Value to convert.

Examples

Convert a string to a duration

duration(v: "1h20m")// Returns 1h20m

Convert numeric types to durations

duration(v: 4800000000000)

// Returns 1h20m
duration(v: uint(v: 9600000000000))// Returns 2h40m

Convert values in a column to durations

Flux does not support duration column types. To store durations in a column, convert duration types to strings.

data
    |> map(fn: (r) => ({r with _value: string(v: duration(v: r._value))}))

View example input and ouput


Was this page helpful?

Thank you for your feedback!


Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.