Python Pandas PeriodIndex构造函数用法及代码示例

Pandas PeriodIndex(~)构造函数创建一个新的PeriodIndex对象，代表一个特定的时间跨度或持续时间.PeriodIndex最常用作 DataFrame 的索引。

注意

PeriodIndex和 DatetimeIndex 的区别如下：

PeriodIndex代表一个时间跨度具有精确的开始和结束时间。
DatetimeIndex构造函数代表一个特定时间点.

警告

不要直接调用这个构造函数，而是选择使用 period_range(~) ，这样更灵活，使用也更广泛。

参数

1.data | array-like | optional

类似数组，包含构造 PeriodIndex 的日期。

2. copy | boolean | optional

如果 True ，则将返回 data 的新副本 - 修改此复制的数据不会改变原始 data ，反之亦然。
如果 False ，则返回的 PeriodIndex 将使用与 data 相同的内存块。这意味着修改返回值将改变原始的 data ，反之亦然。

默认情况下，copy=False 。

3. freq | string 或 Period | optional

PeriodIndex 的频率。您可以将 freq 视为时间跨度的间隔大小。默认情况下，频率是从 data 推断的。

4. year | int 或 array 或 Series | optional

默认情况下，year=None 。

5. month | int 或 array 或 Series | optional

默认情况下，month=None 。

6. quarter | int 或 array 或 Series | optional

默认情况下，quarter=None 。

7. day | int 或 array 或 Series | optional

默认情况下，day=None 。

8. hour | int 或 array 或 Series | optional

默认情况下，hour=None 。

9. minute | int 或 array 或 Series | optional

默认情况下，minute=None 。

10.second | int 或 array 或 Series | optional

默认情况下，second=None 。

11.tz | object | optional

从 datetime64 转换为 PeriodIndex 时使用的时区。默认情况下，tz=None 。

返回值

PeriodIndex 对象。

例子

基本用法

要使用日期字符串列表创建PeriodIndex：

index_period = pd.PeriodIndex(["2020-12-25", "2020-12-26"], freq="D")
index_period



PeriodIndex(['2020-12-25', '2020-12-26'], dtype='period[D]', freq='D')

这里，freq="D"表示每个周期的间隔大小是一天。

然后我们可以使用PeriodIndex作为DataFrame的索引，如下所示：

pd.DataFrame({"A":["a","b"]}, index=index_period)



            A
2020-12-25  a
2020-12-26  b

指定频率

要指定 PeriodIndex 的间隔大小，请像这样设置 freq：

index_period = pd.PeriodIndex(["2020-12-25", "2020-12-26"], freq="2D")
index_period



PeriodIndex(['2020-12-25', '2020-12-26'], dtype='period[2D]', freq='2D')

指定各个时间参数

您可以使用单独的时间参数创建 PeriodIndex，而不是传入 data ，如下所示：

idx = pd.PeriodIndex(year=[2000, 2002], month=[5,6], day=[10,11], freq="D")
idx



PeriodIndex(['2000-05-10', '2002-06-11'], dtype='period[D]', freq='D')

指定 tz

要使 PeriodIndex 时区感知：

pd.PeriodIndex(["2020-12-25"], freq="D", tz="Asia/Tokyo")



PeriodIndex(['2020-12-25'], dtype='period[D]', freq='D')

相关用法

注：本文由纯净天空筛选整理自Isshin Inada大神的英文原创作品 Pandas | PeriodIndex constructor。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。