polars.Series.shift

Series.shift(
    n: int = 1,
    *,
    fill_value: IntoExpr | None = None,
) → Series

Сдвигает значения на заданное количество индексов.

Параметры:

n

Количество индексов для сдвига вперёд. Если передано отрицательное значение, значения сдвигаются в противоположном направлении.

fill_value

Заполнить получившиеся значения null этим значением. Принимает скалярное выражение. Входные данные, не являющиеся выражениями, интерпретируются как литералы.

Примечания

Этот метод аналогичен операции LAG в SQL, когда значение n положительно. При отрицательном значении n он аналогичен LEAD.

Примеры

По умолчанию значения сдвигаются вперёд на один индекс.

>>> s = pl.Series([1, 2, 3, 4])
>>> s.shift()
shape: (4,)
Series: '' [i64]
[
    null
    1
    2
    3
]

Передайте отрицательное значение, чтобы сдвинуть значения в противоположном направлении.

>>> s.shift(-2)
shape: (4,)
Series: '' [i64]
[
    3
    4
    null
    null
]

Укажите fill_value, чтобы заполнить получившиеся значения null.

>>> s.shift(-2, fill_value=100)
shape: (4,)
Series: '' [i64]
[
    3
    4
    100
    100
]