pandas.arrays.PeriodArray#

class pandas.arrays.PeriodArray(values, dtype=None, copy=False)[源代码][源代码]#

用于存储Period数据的Pandas ExtensionArray。

用户应使用 array() 来创建新实例。

参数:
值Union[PeriodArray, Series[period], ndarray[int], PeriodIndex]

要存储的数据。这些应该是可以直接转换为序数的数组，无需推理或复制（PeriodArray, ndarray[int64]），或围绕此类数组的框（Series[period], PeriodIndex）。

dtypePeriodDtype，可选

一个 PeriodDtype 实例，从中提取 freq。如果同时指定了 freq 和 dtype，则频率必须匹配。

复制bool, 默认 False

是否在存储之前复制序数。

属性

None

方法

None

参见

周期

表示一段时间。

PeriodIndex

周期数据的不可变索引。

period_range

创建一个固定频率的 PeriodArray。

数组

构建一个 pandas 数组。

备注

PeriodArray 有两个组成部分

  • ordinals : 整数 ndarray

  • freq : pd.tseries.offsets.Offset

这些值在物理上存储为一个整数的 1-D ndarray。这些被称为“序数”，并表示某种从基数的偏移。

freq 表示数组中每个元素覆盖的时间间隔。PeriodArray 中的所有元素具有相同的 freq。

例子

>>> pd.arrays.PeriodArray(pd.PeriodIndex(["2023-01-01", "2023-01-02"], freq="D"))
<PeriodArray>
['2023-01-01', '2023-01-02']
Length: 2, dtype: period[D]