Python Pandas - 指定したPeriodオブジェクトに適用された時系列頻度の文字列エイリアスを取得する方法

指定したPeriodオブジェクトに適用されている時系列頻度（frequency）の文字列エイリアスを取得するには、period.freqstrプロパティを使用します。このプロパティは、Periodオブジェクトに設定された頻度を「<Second>」や「<YearEnd: month=12>」といった文字列表現で返します。

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

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

import pandas as pd

pandas.Periodは、特定の期間（時間帯）を表すオブジェクトです。ここでは、2つのPeriodオブジェクトを作成してみましょう。

period1 = pd.Period("2020-09-23 03:55:20")
period2 = pd.Period(freq="Y", year=2021, month=2, day=14, hour=2, minute=35)

1つ目のPeriodは日時文字列から生成され、頻度が明示されていないためデフォルトの「秒」単位になります。2つ目のPeriodはfreq引数で「Y」（年次）を指定して作成しています。

Periodオブジェクトの表示

作成したPeriodオブジェクトを表示して確認します。

print("Period1...
", period1)
print("Period2...
", period2)

頻度の文字列エイリアスを取得する

freqstrプロパティを使って、各Periodオブジェクトの頻度の文字列エイリアスを取得します。

res1 = period1.freqstr
res2 = period2.freqstr

完全なサンプルコード

以下に、ここまでの手順をまとめたコード全体を示します。

import pandas as pd

# pandas.Periodは期間を表すオブジェクト
# 2つのPeriodオブジェクトを作成
period1 = pd.Period("2020-09-23 03:55:20")
period2 = pd.Period(freq="Y", year=2021, month=2, day=14, hour=2, minute=35)

# Periodオブジェクトを表示
print("Period1...
", period1)
print("Period2...
", period2)

# 頻度の文字列エイリアスを取得
res1 = period1.freqstr
res2 = period2.freqstr

# 各Periodオブジェクトの頻度の文字列エイリアスを表示
print("
1つ目のPeriodオブジェクトの頻度の文字列エイリアス ...
", res1)
print("
2つ目のPeriodオブジェクトの頻度の文字列エイリアス ...
", res2)

実行結果

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

Period1...
2020-09-23 03:55:20

Period2...
2021

1つ目のPeriodオブジェクトの頻度の文字列エイリアス ...
<Second>

2つ目のPeriodオブジェクトの頻度の文字列エイリアス ...
<YearEnd: month=12>

このように、日時文字列のみから作成したPeriodオブジェクトでは頻度が「<Second>」と判定され、freq="Y"を指定したPeriodオブジェクトでは「<YearEnd: month=12>」（年末基準の年次頻度）が返されることがわかります。