Python Pandas – PeriodIndexオブジェクトから頻度（freq）オブジェクトを取得する方法

PeriodIndex.freqプロパティとは

PandasのPeriodIndexオブジェクトから頻度（frequency）オブジェクトを取得するには、PeriodIndex.freqプロパティを使用します。このプロパティは、PeriodIndexに設定されている頻度情報をそのまま返してくれるため、時系列データの周期性を確認したい場合に便利です。

まず、必要なライブラリをインポートしましょう。

import pandas as pd

次に、PeriodIndexオブジェクトを作成します。ここでは「freq」パラメータを使って、頻度を「D」（日次）に設定しています。

periodIndex = pd.PeriodIndex(['2021-09-25', '2019-10-30', '2020-11-20',
'2021-07-15', '2022-06-12', '2023-07-10'], freq="D")

作成したPeriodIndexオブジェクトを表示してみます。

print("PeriodIndex...\n", periodIndex)

続いて、PeriodIndexの頻度を表示します。

print("\nPeriodIndex frequency...\n", periodIndex.freq)

サンプルコード

以下は、ここまでの手順をまとめた完全なコード例です。あわせて、各期間の月番号（1＝1月、2＝2月…12＝12月）を取得するmonth属性の使い方も確認できます。

import pandas as pd

# PeriodIndexオブジェクトを作成
# PeriodIndexは、時間軸上の一定の期間を示す序数値を保持する不変のndarrayです
# 「freq」パラメータで頻度を設定しています
periodIndex = pd.PeriodIndex(['2021-09-25', '2019-10-30', '2020-11-20',
'2021-07-15', '2022-06-12', '2023-07-10'], freq="D")

# PeriodIndexオブジェクトを表示
print("PeriodIndex...\n", periodIndex)

# PeriodIndexの頻度を表示
print("\nPeriodIndex frequency...\n", periodIndex.freq)

# 月番号を表示（1 = 1月、2 = 2月 ... 12 = 12月）
print("\nMonth number...\n", periodIndex.month)

出力結果

上記のコードを実行すると、次のような出力が得られます。

PeriodIndex...
PeriodIndex(['2021-09-25', '2019-10-30', '2020-11-20', '2021-07-15', '2022-06-12', '2023-07-10'],
dtype='period[D]')

PeriodIndex frequency...
<Day>

Month number...
Int64Index([9, 10, 11, 7, 6, 7], dtype='int64')

ポイントのまとめ

• PeriodIndex.freq：PeriodIndexに設定された頻度オブジェクトを返すプロパティです。上記の例では日次を表す「<Day>」が返されます。
• freqパラメータ：「D」（日次）のほか、「M」（月次）、「Y」（年次）、「H」（時間単位）など、さまざまな頻度文字列を指定できます。
• month属性：各期間の月番号をInt64Indexとして取得でき、月ごとの集計やフィルタリングに活用できます。