Python Pandas – PeriodIndexオブジェクトから頻度オブジェクトを文字列として取得する方法

PeriodIndexオブジェクトから頻度（frequency）オブジェクトを文字列として取得するには、PeriodIndex.freqstrプロパティを使用します。この記事では、実際のコード例を通じてその使い方をわかりやすく解説します。

必要なライブラリのインポート

まず、pandasライブラリをインポートします。

import pandas as pd

PeriodIndexオブジェクトの作成

次に、PeriodIndexオブジェクトを作成します。PeriodIndexは、時間軸上の一定期間を示す序数値を保持する不変（immutable）なndarrayです。「freq」パラメータで頻度を指定できます。

periodIndex = pd.PeriodIndex(['2021-09-25 07:50:35', '2019-10-30 04:35:45',
'2021-07-15 02:25:15', '2022-06-25 07:20:55'], freq="T")

PeriodIndexオブジェクトの表示

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

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

頻度オブジェクトを文字列として表示

freqstrプロパティを使うと、頻度オブジェクトを文字列形式で取得できます。

print("\nPeriodIndex frequency object as a string...\n", periodIndex.freqstr)

完全なコード例

以下に、ここまでの内容をまとめた完全なコードを示します。

import pandas as pd

# PeriodIndexオブジェクトを作成
# PeriodIndexは、時間軸上の一定期間を示す序数値を保持する不変なndarray
# 「freq」パラメータで頻度を設定
periodIndex = pd.PeriodIndex(['2021-09-25 07:50:35', '2019-10-30 04:35:45',
'2021-07-15 02:25:15', '2022-06-25 07:20:55'], freq="T")

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

# PeriodIndexの頻度オブジェクトを表示
print("\nPeriodIndex frequency object...\n", periodIndex.freq)

# PeriodIndexの頻度オブジェクトを文字列として表示
print("\nPeriodIndex frequency object as a string...\n", periodIndex.freqstr)

実行結果

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

PeriodIndex...
PeriodIndex(['2021-09-25 07:50', '2019-10-30 04:35', '2021-07-15 02:25', '2022-06-25 07:20'],
dtype='period[T]')

PeriodIndex frequency object...
<Minute>

PeriodIndex frequency object as a string...
T

まとめ

freqstrプロパティを使えば、PeriodIndexの頻度情報を簡単に文字列として取得できます。freqプロパティが頻度オブジェクト自体（この例では<Minute>）を返すのに対し、freqstrは「T」という文字列表現を返す点がポイントです。時系列データの分析において、頻度情報を確認・活用したい場面でぜひ活用してください。