timeShift() function

The timeShift() function adds a fixed duration to time columns. The output table schema is the same as the input table. If the time is null, the time will continue to be null.

*Function type: Transformation*

timeShift(duration: 10h, columns: ["_start", "_stop", "_time"])

Parameters

duration

The amount of time to add to each time value. May be a negative duration.

*Data type: Duration*

columns

The list of all columns to be shifted. Defaults to ["_start", "_stop", "_time"].

*Data type: Array of strings*

Examples

Shift forward in time

from(bucket: "example-bucket")
    |> range(start: -5m)
    |> timeShift(duration: 12h)

Shift backward in time

from(bucket: "example-bucket")
    |> range(start: -5m)
    |> timeShift(duration: -12h)