Python Pandas – 指定したDateOffsetオブジェクトに適用された頻度を返す方法

Pandasで指定されたDateOffsetオブジェクトに適用されている頻度を取得するには、offset.freqstr属性を使用します。この属性は、DateOffsetオブジェクトに設定された頻度を「5D」のような文字列形式で返してくれます。また、to_offset()関数を使うことで、頻度を表す文字列からDateOffsetオブジェクトを簡単に生成できます。

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

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

次に、Pandasでタイムスタンプオブジェクトを作成します。

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

DateOffsetを作成します。ここでは「D」（日）の頻度を使用し、5日分の日数を加算するオフセットを定義しています。

offset = to_offset("5D")

オフセットを適用した更新後のタイムスタンプを表示します。

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

最後に、指定されたDateOffsetオブジェクトに適用された頻度をfreqstrで取得して表示します。

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

コード例

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

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

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

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

# DateOffsetを作成
# 「D」の頻度を使って5日分を加算
offset = to_offset("5D")

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

# オフセット適用後のタイムスタンプを表示
print("\nUpdated Timestamp...\n", timestamp + offset)

# 指定されたDateOffsetオブジェクトに適用された頻度を返す
print("\nThe frequency on the DateOffset object..\n", offset.freqstr)

実行結果

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

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

DateOffset...
 <5 * Days>

Updated Timestamp...
 2021-10-01 03:25:02.000045

The frequency on the DateOffset object..
 5D

このように、元のタイムスタンプ「2021-09-26」に5日間のオフセットが適用され、「2021-10-01」という新しい日付が生成されています。そしてfreqstr属性により、そのDateOffsetオブジェクトに設定された頻度「5D」が文字列として正しく返されていることが確認できます。