pandas.api.extensions.ExtensionArray.shift

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

按所需数量移动值。

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

参数:

时期int, 默认 1

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

fill_value对象，可选

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

返回:

ExtensionArray

Shifted.

参见

api.extensions.ExtensionArray.transpose

返回此数组的转置视图。

api.extensions.ExtensionArray.factorize

将扩展数组编码为枚举类型。

备注

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

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

对于二维的 ExtensionArrays，我们总是在 axis=0 上进行移位。

例子

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