Python Pandas入門：BusinessDayオフセットオブジェクトのキーワード引数（kwds）を表示する方法

Pandasで指定した BusinessDay オフセットオブジェクトに適用されているキーワード引数を確認するには、BusinessDay.kwds プロパティを使用します。このプロパティは、オフセット作成時に渡されたキーワード引数を辞書形式で返してくれます。

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

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

import datetime
import pandas as pd

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

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

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

BusinessDayオフセットの作成

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

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

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

オフセットを適用した後のタイムスタンプを表示してみましょう。

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

キーワード引数の表示

kwds プロパティを使って、キーワード引数を表示します。

print("\nKeyword arguments on the given BusinessDay Offset...\n", bdOffset.kwds)

サンプルコード（完全版）

以下が全体のコード例です。

import datetime
import pandas as pd

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

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

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

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

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

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

# キーワード引数を表示
print("\nKeyword arguments on the given BusinessDay Offset...\n", bdOffset.kwds)

実行結果

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

Timestamp...
 2021-10-30 01:55:02.000045

BusinessDay Offset...
 <BusinessDay: offset=datetime.timedelta(seconds=25620)>

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

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

Keyword arguments on the given BusinessDay Offset...
 {'offset': datetime.timedelta(seconds=25620)}

解説

実行結果からわかるように、kwds プロパティは {'offset': datetime.timedelta(seconds=25620)} という辞書を返しています。これは、BusinessDayオフセットを作成する際に offset 引数として7時間7分（25620秒）のtimedeltaオブジェクトを指定したためです。

また、タイムスタンプ「2021-10-30 01:55:02」にBusinessDayオフセットを加算すると、「2021-11-01 09:02:02」という結果になっています。10月30日が土曜日であるため、次の営業日である11月1日（月曜日）に移動し、さらに7時間7分のオフセットが加算されたことが確認できます。