Python Pandas – 指定したCustomBusinessDayオフセットオブジェクトに適用された頻度名を取得する方法

指定された CustomBusinessDay オフセットオブジェクトに適用されている頻度の名前を取得するには、CustomBusinessDay.name プロパティを使用します。このプロパティは、オフセットオブジェクトが持つ頻度の基本名（例：「C」）を文字列として返します。

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

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

import pandas as pd

タイムスタンプオブジェクトの作成

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

timestamp = pd.Timestamp('2021-12-31 08:35:10')

CustomBusinessDayオフセットの作成

CustomBusinessDayオフセットを作成します。CustomBusinessDay は、祝日などを除外したカスタム営業日を表す DateOffset のサブクラスです。ここでは、n=2（2営業日分のオフセット）と、有効な営業日を指定する weekmask='Mon Tue Wed Fri'（月・火・水・金を営業日とする）を設定しています。

cbdOffset = pd.tseries.offsets.CustomBusinessDay(n = 2, weekmask = 'Mon Tue Wed Fri')

タイムスタンプへのオフセット適用

タイムスタンプにオフセットを加算し、更新後のタイムスタンプを表示します。

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

頻度名の取得

指定されたCustomBusinessDayオブジェクトに適用されている頻度の名前を返します。

print("\nThe name of the frequency on the CustomBusinessDay object..\n", cbdOffset.name)

完全なコード例

以下に全体のコードを示します。

import pandas as pd

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

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

# CustomBusinessDayオフセットを作成
# CustomBusinessDayは、祝日を除外したカスタム営業日を表すDateOffsetのサブクラス
# weekmaskで有効な営業日を指定
cbdOffset = pd.tseries.offsets.CustomBusinessDay(n = 2, weekmask = 'Mon Tue Wed Fri')

# CustomBusinessDayオフセットを表示
print("\nCustomBusinessDay Offset...\n", cbdOffset)

# タイムスタンプにオフセットを加算し、更新後のタイムスタンプを表示
print("\nUpdated Timestamp...\n", timestamp + cbdOffset)

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

# 指定されたCustomBusinessDayオブジェクトに適用された頻度の名前を返す
print("\nThe name of the frequency on the CustomBusinessDay object..\n", cbdOffset.name)

実行結果

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

Timestamp...
 2021-12-31 08:35:10

CustomBusinessDay Offset...
 <2 * CustomBusinessDays>

Updated Timestamp...
 2022-01-04 08:35:10

Frequency applied on the given CustomBusinessDay Offset object...
 2C

The name of the frequency on the CustomBusinessDay object..
 C

出力の解説

元のタイムスタンプ「2021-12-31」は金曜日です。weekmaskでは木曜日が除外されているため、2営業日後は翌週の火曜日「2022-01-04」となります。また、freqstr プロパティは頻度を「2C」という文字列で返しますが、name プロパティは基本となる頻度名「C」（CustomBusinessDay）のみを返す点に注意してください。