Python・Pandas入門：オフセットオブジェクトに適用された頻度の名前を取得する方法

Pandasでオフセット（DateOffset）オブジェクトに適用されている頻度の名前を取得するには、offset.name プロパティを使用します。この記事では、具体的なコード例とともにその使い方を解説します。

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

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

from pandas.tseries.frequencies import to_offset
import pandas as pd

タイムスタンプの作成

Pandasでタイムスタンプオブジェクトを設定します。

timestamp = pd.Timestamp('2021-09-26 03:25:02.000045')

DateOffsetの作成

次に、DateOffsetを作成します。ここでは「M」（月）頻度を使って月を加算するオフセットを生成しています。

offset = to_offset("3M")

更新後のタイムスタンプを表示

元のタイムスタンプにオフセットを加算した結果を表示します。

print("\nUpdated Timestamp...\n", timestamp + offset)

頻度の名前を取得

対象のDateOffsetオブジェクトに適用されている頻度の名前を返します。

print("\nThe name of the frequency on the DateOffset object..\n", offset.name)

完全なコード例

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

from pandas.tseries.frequencies import to_offset
import pandas as pd

# タイムスタンプオブジェクトを設定
timestamp = pd.Timestamp('2021-09-26 03:25:02.000045')

# タイムスタンプを表示
print("Timestamp...\n", timestamp)

# DateOffsetを作成
# 「M」頻度を使用して月を加算
offset = to_offset("3M")

# DateOffsetを表示
print("\nDateOffset...\n", offset)

# 更新後のタイムスタンプを表示
print("\nUpdated Timestamp...\n", timestamp + offset)

# DateOffsetオブジェクトに適用された頻度の名前を取得
print("\nThe name of the frequency on the DateOffset object..\n", offset.name)

実行結果

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

Timestamp...
 2021-09-26 03:25:02.000045

DateOffset...
 <3 * MonthEnds>

Updated Timestamp...
 2021-11-30 03:25:02.000045

The name of the frequency on the DateOffset object..
 M

ポイント解説

• to_offset() 関数は、文字列形式の頻度指定（例：「3M」「D」「W」など）を対応するDateOffsetオブジェクトに変換します。
• offset.name プロパティは、そのオフセットに適用されている頻度の名前を文字列として返します。この例では「3M」という頻度に対して「M」が返されています。
• 「3 * MonthEnds」と表示されていることから、このオフセットが「月末を基準に3か月進める」処理であることがわかります。実際、2021年9月26日のタイムスタンプに適用すると、2021年11月30日（11月の月末）に移動しています。