Python Pandas – 指定されたDateOffsetオブジェクトに適用される頻度を文字列として取得する方法

指定された DateOffset オブジェクトに適用されている頻度を文字列として取得するには、Pandas の offset.freqstr プロパティを使用します。このプロパティを使うことで、DateOffset オブジェクトに設定された頻度の情報を簡単に確認できます。

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

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

from pandas.tseries.offsets import DateOffset
import pandas as pd

タイムスタンプオブジェクトの設定

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

timestamp = pd.Timestamp('2021-08-30 02:30:55')

DateOffset オブジェクトの作成

次に、DateOffset を作成します。ここでは「months」パラメータを使用して、月数を加算するオフセットを設定しています。

offset = pd.tseries.offsets.DateOffset(months=3)

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

元のタイムスタンプに DateOffset を適用した結果を表示します。

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

頻度の文字列表現を取得

指定された DateOffset オブジェクトに適用されている頻度を文字列として表示します。

print("\nFrequency on the given DataOffset...\n", offset.freqstr)

完全なコード例

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

from pandas.tseries.offsets import DateOffset
import pandas as pd

# Pandasでタイムスタンプオブジェクトを設定
timestamp = pd.Timestamp('2021-08-30 02:30:55')

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

# DateOffsetを作成
# 「months」パラメータを使用して月数を加算
offset = pd.tseries.offsets.DateOffset(months=3)

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

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

# 指定されたDateOffsetオブジェクトに適用される頻度を文字列として取得
print("\nFrequency on the given DataOffset...\n", offset.freqstr)

実行結果

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

Timestamp...
2021-08-30 02:30:55

DateOffset...
<DateOffset: months=3>

Updated Timestamp...
2021-11-30 02:30:55

Frequency on the given DataOffset...
<DateOffset: months=3>

まとめ

freqstr プロパティは、DateOffset オブジェクトに設定された頻度情報を文字列形式で返します。この例では「months=3」という3か月ごとのオフセットが設定されており、元のタイムスタンプ「2021-08-30」に適用すると「2021-11-30」へと更新されます。時系列データの操作において、オフセットの内容を確認したい場合に非常に便利な機能です。