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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。