pandas.api.extensions.ExtensionArray.shift

ExtensionArray.shift(periods=1, fill_value=None)

按所需数量移动值。

新引入的缺失值将用 self.dtype.na_value 填充。

Parameters:

periodsint, 默认值 1

移动的周期数。允许使用负值向后移动。

fill_valueobject, optional

用于新引入的缺失值的标量。默认为 self.dtype.na_value。

Returns:

ExtensionArray

移动后的数组。

Notes

如果 self 为空或 periods 为 0，则返回 self 的副本。

如果 periods > len(self)，则返回一个大小为 len(self) 的数组，所有值都用 self.dtype.na_value 填充。

对于二维 ExtensionArrays，我们始终沿 axis=0 进行移动。

Examples

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