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

指定されたBusinessDay（営業日）オフセットオブジェクトに適用されている頻度を文字列として取得するには、PandasのBusinessDay.freqstrプロパティを使用します。このプロパティは、オフセットオブジェクトが持つ頻度情報を「B+7D7H7Min」のような読みやすい文字列形式で返します。

実装手順

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

import datetime
import pandas as pd

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

timestamp = pd.Timestamp('2021-1-1 01:55:02.000045')

次に、BusinessDayオフセットを作成します。BusinessDayはDateOffsetのサブクラスであり、営業日に基づいた日付計算を行うために使用されます。

bdOffset = pd.tseries.offsets.BusinessDay(offset = datetime.timedelta(days = 7, hours = 7, minutes = 7))

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

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

最後に、指定されたBusinessDayオブジェクトに適用されている頻度を文字列として取得します。

print("\nFrequency on the given BusinessDay Offset...\n", bdOffset.freqstr)

完全なコード例

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

import datetime
import pandas as pd

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

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

# BusinessDayオフセットを作成
# BusinessDayはDateOffsetのサブクラス
bdOffset = pd.tseries.offsets.BusinessDay(offset = datetime.timedelta(days = 7, hours = 7, minutes = 7))

# BusinessDayオフセットを表示
print("BusinessDay Offset...\n", bdOffset)

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

# 指定されたBusinessDayオブジェクトに適用される頻度を文字列として返す
print("\nFrequency on the given BusinessDay Offset...\n", bdOffset.freqstr)

出力結果

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

Timestamp...
 2021-01-01 01:55:02.000045
BusinessDay Offset...
 <BusinessDay: offset=datetime.timedelta(days=7, seconds=25620)>

Updated Timestamp...
 2021-01-11 09:02:02.000045

Frequency on the given BusinessDay Offset...
 B+7D7H7Min

出力からわかるように、freqstrプロパティは「B+7D7H7Min」という形式で頻度を返しています。これは「営業日ベース（B）」に加えて、7日・7時間・7分のオフセットが適用されていることを表しています。このようにfreqstrを使うことで、オフセットオブジェクトの内部設定をひと目で確認でき、時系列データの処理やデバッグの際に非常に便利です。