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:

inputoutput
anyany

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
╰───┴───╯