docs-v2/content/v2.0/reference/flux/functions/built-in/transformations/shift.md

title	description	aliases	menu	weight
shift() function	The shift() function adds a fixed duration to time columns.	/v2.0/reference/flux/functions/transformations/shift	v2_0_ref name parent shift built-in-transformations	401

The shift() 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
Output data type: Object

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

Parameters

shift

The amount of time to add to each time value. The shift 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: "telegraf/autogen")
	|> range(start: -5m)
	|> shift(shift: 12h)

Shift backward in time

from(bucket: "telegraf/autogen")
	|> range(start: -5m)
	|> shift(shift: -12h)