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

Parameters

v

(Required) Value to convert.

Examples

• Convert a string to a duration
• Convert numeric types to durations
• Convert values in a column to durations

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))}))