polars shift for [dataframe or lazyframe](/commands/categories/dataframe or lazyframe.md)

Shifts the values by a given period.

Signature

> polars shift {flags} (period)

Flags

• --fill, -f {any}: Expression used to fill the null values (lazy df)

Parameters

• period: shift period

Input/output types:

input	output
any	any

Examples

Shifts the values by a given period

> [1 2 2 3 3] | polars into-df | polars shift 2 | polars drop-nulls
╭───┬───╮
│ # │ 0 │
├───┼───┤
│ 0 │ 1 │
│ 1 │ 2 │
│ 2 │ 2 │
╰───┴───╯

Shifts the values by a given period, fill absent values with 0

> [1 2 2 3 3] | polars into-lazy | polars shift 2 --fill 0 | polars collect
╭───┬───╮
│ # │ 0 │
├───┼───┤
│ 0 │ 0 │
│ 1 │ 0 │
│ 2 │ 1 │
│ 3 │ 2 │
│ 4 │ 2 │
╰───┴───╯