Python PandasでCustomBusinessHourオフセットオブジェクトを作成する方法

PandasでCustomBusinessHour（カスタム営業時間）オブジェクトを作成するには、pandas.tseries.offsets.CustomBusinessHour()メソッドを使用します。CustomBusinessHourはDateOffsetのサブクラスであり、営業日や営業時間帯を自由にカスタマイズできる便利なオフセット機能です。

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

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

import pandas as pd

タイムスタンプの設定

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

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

CustomBusinessHourオフセットの作成

CustomBusinessHourオフセットを作成します。CustomBusinessHourはDateOffsetのサブクラスです。

nパラメータには移動させる営業時間の数を指定し、weekmaskパラメータには有効な営業日を指定します。ここでは「月・火・水・金」を営業日として設定しています（木曜日は除外されています）。

cbhOffset = pd.tseries.offsets.CustomBusinessHour(n = 5, weekmask = 'Mon Tue Wed Fri')

オフセットの表示

作成したCustomBusinessHourオフセットを表示します。

print("\nCustomBusinessHour Offset...\n", cbhOffset)

タイムスタンプへのオフセットの加算

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

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

コード例

以下に完全なコードを示します。

import pandas as pd

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

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

# CustomBusinessHourオフセットを作成
# CustomBusinessHourはDateOffsetのサブクラス
# weekmaskで有効な営業日を指定
cbhOffset = pd.tseries.offsets.CustomBusinessHour(n = 5, weekmask = 'Mon Tue Wed Fri')

# CustomBusinessHourオフセットを表示
print("\nCustomBusinessHour Offset...\n", cbhOffset)

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

出力結果

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

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

CustomBusinessHour Offset...
 <5 * CustomBusinessHours: CBH=09:00-17:00>

Updated Timestamp...
 2021-12-31 14:00:00

このように、CustomBusinessHourオフセットを使用することで、デフォルトの営業時間（09:00〜17:00）と指定した営業日に基づいて、タイムスタンプを正確に進めることができます。元のタイムスタンプは08:35:10ですが、営業開始時刻が09:00であるため、まず09:00まで移動してから5営業時間分が加算され、14:00:00という結果になっています。