time() function

time() converts a value to a time type.

Function type signature

(v: A) => time

Parameters

v

(Required) Value to convert.

Strings must be valid RFC3339 timestamps. Integer and unsigned integer values are parsed as nanosecond epoch timestamps.

Examples

• Convert a string to a time value
• Convert an integer to a time value
• Convert all values in a column to time

Convert a string to a time value

time(v: "2021-01-01T00:00:00Z")// Returns 2021-01-01T00:00:00Z (time)

Convert an integer to a time value

time(v: 1640995200000000000)// Returns 2022-01-01T00:00:00Z

Convert all values in a column to time

If converting the _value column to time types, use toTime(). If converting columns other than _value, use map() to iterate over each row and time() to convert a column value to a time type.

data
    |> map(fn: (r) => ({r with exampleCol: time(v: r.exampleCol)}))