Pandas Data Offsets：CustomBusinessHour.rule_code徹底解説

Pandas Data Offsets と CustomBusinessHour.rule_code の解説

CustomBusinessHour は、Data Offsets の一種で、営業時間 に基づいて日付をオフセットします。つまり、土日や祝日などを除いて、ビジネス日のみオフセットを進めることができます。

CustomBusinessHour.rule_code は、このオフセットの規則を表す文字列です。以下の情報が含まれます。

• 開始時間: 営業日の開始時間 (例: "09:00")
• 終了時間: 営業日の終了時間 (例: "17:00")
• 週マスク: 曜日ごとに営業日かどうかを表すビットマスク (例: "MoTuWeThFr")
• 祝日: 営業日として除外される祝日のリスト

例:

from pandas.tseries.offsets import CustomBusinessHour

# 営業時間が 9:00 から 17:00 までの平日
offset = CustomBusinessHour(start="09:00", end="17:00")

# 2024-03-26 に 2 営業日オフセットを加算
date = pd.to_datetime("2024-03-26") + offset

# 結果: 2024-03-28
print(date)

CustomBusinessHour.rule_code の値は、以下の形式で生成されます。

"C<start>-<end><weekmask>"

例:

# 上記の例の場合
offset.rule_code
# 出力: 'C09:00-17:00MoTuWeThFr'

Pandas CustomBusinessHour サンプルコード

営業日のみオフセットを加算

from pandas.tseries.offsets import CustomBusinessHour

# 営業時間が 9:00 から 17:00 までの平日
offset = CustomBusinessHour(start="09:00", end="17:00")

# 2024-03-26 に 2 営業日オフセットを加算
date = pd.to_datetime("2024-03-26") + offset * 2

# 結果: 2024-03-30
print(date)

祝日を除外

from pandas.tseries.offsets import CustomBusinessHour

# 祝日
holidays = ["2024-03-28", "2024-03-29"]

# 営業時間が 9:00 から 17:00 までの平日、祝日を除外
offset = CustomBusinessHour(start="09:00", end="17:00", holidays=holidays)

# 2024-03-26 に 2 営業日オフセットを加算
date = pd.to_datetime("2024-03-26") + offset * 2

# 結果: 2024-04-02
print(date)

週マスクで特定の曜日を除外

from pandas.tseries.offsets import CustomBusinessHour

# 営業時間が 9:00 から 17:00 までの月・水・金曜日
offset = CustomBusinessHour(start="09:00", end="17:00", weekmask="MoWeFr")

# 2024-03-26 に 2 営業日オフセットを加算
date = pd.to_datetime("2024-03-26") + offset * 2

# 結果: 2024-04-05
print(date)

複雑な営業時間帯

from pandas.tseries.offsets import CustomBusinessHour

# 午前 9:00 から 12:00、午後 13:00 から 17:00 までの平日
offset = CustomBusinessHour(start=["09:00", "13:00"], end=["12:00", "17:00"])

# 2024-03-26 に 1 営業日オフセットを加算
date = pd.to_datetime("2024-03-26") + offset

# 結果: 2024-03-27
print(date)

営業日数をカウント

from pandas.tseries.offsets import CustomBusinessHour

# 営業時間が 9:00 から 17:00 までの平日
offset = CustomBusinessHour(start="09:00", end="17:00")

# 2024-03-26 から 2024-04-05 までの営業日数
business_days = CustomBusinessHour.apply_index(
    pd.date_range("2024-03-26", "2024-04-05")
)

# 結果: 7
print(business_days.sum())

これらのサンプルコードは、CustomBusinessHour の基本的な使い方を理解するのに役立ちます。より複雑なユースケースについては、公式ドキュメント: https://pandas.pydata.org/docs/reference/api/pandas.tseries.offsets.CustomBusinessHour.html を参照してください。

Pandas で営業日オフセットを設定する他の方法

from pandas import DateOffset

# 営業日オフセット
business_day_offset = DateOffset(days=1)

# 2024-03-26 から 5 営業日先のリスト
business_days = []
date = pd.to_datetime("2024-03-26")
for _ in range(5):
    while not is_business_day(date):
        date += business_day_offset
    business_days.append(date)
    date += business_day_offset

# 結果: ['2024-03-26', '2024-03-27', '2024-03-28', '2024-04-02', '2024-04-03']
print(business_days)

# 祝日判定関数
def is_business_day(date):
    # 祝日リスト
    holidays = ["2024-03-28", "2024-03-29"]
    return date.weekday() < 5 and date not in holidays

pandas.to_datetime() と holidays パラメータ

from pandas import to_datetime

# 営業日オフセット
business_day_offset = "B"

# 2024-03-26 から 5 営業日先のリスト
business_days = to_datetime(pd.date_range("2024-03-26", periods=5, freq=business_day_offset, holidays=["2024-03-28", "2024-03-29"]))

# 結果: ['2024-03-26', '2024-03-27', '2024-03-28', '2024-04-02', '2024-04-03']
print(business_days)

これらの方法は、CustomBusinessHour よりも柔軟性がありますが、コード量が増えたり、外部ライブラリのインストールが必要になったりする場合があります。

注意事項

• これらの方法は、あくまで参考例です。実際のユースケースに合わせて、コードを修正する必要があります。
• 祝日や営業時間帯は、地域や企業によって異なる場合があります。コードを使用する前に、正確な情報を確認してください。