pandas.api.extensions.ExtensionArray.shift

ExtensionArray.shift(periods=1, fill_value=None)[source]

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

Новые пропущенные значения заполняются значением self.dtype.na_value.

Parameters:

periods:int, по умолчанию 1

Количество позиций для сдвига. Допускаются отрицательные значения для сдвига назад.

fill_value:object, необязательно

Скалярное значение, используемое для заполнения новых пропущенных значений. По умолчанию self.dtype.na_value.

Returns:

ExtensionArray

Сдвинутый массив.

Примечания

Если self пустой или periods равно 0, возвращается копия self.

Если periods > len(self), тогда возвращается массив размером len(self) со всеми значениями, заполненными self.dtype.na_value.

Для двумерных ExtensionArray всегда происходит сдвиг по оси 0.

Примеры

>>> arr = pd.array([1, 2, 3])
>>> arr.shift(2)
<IntegerArray>
[<NA>, <NA>, 1]
Length: 3, dtype: Int64