Pandas.tseries.offsets.BusinessHour.weekmask徹底解説

pandas.tseries.offsets.BusinessHour.weekmask は、BusinessHour オブジェクトで使用される属性で、曜日ごとにビジネスデーとして扱われるかどうかを指定します。デフォルトでは月曜日から金曜日までの営業日がビジネスデーとなりますが、weekmask を使用して、この設定を変更することができます。

使用例

import pandas as pd

# 月曜日と火曜日をビジネスデーとして設定
weekmask = 'Mon Tue'

# BusinessHour オブジェクトを作成
offset = pd.tseries.offsets.BusinessHour(weekmask=weekmask)

# 日付に BusinessHour オフセットを適用
date = pd.to_datetime('2023-12-24')  # 土曜日
new_date = date + offset

print(new_date)
# 出力: 2023-12-26

上記の例では、月曜日と火曜日をビジネスデーとして設定した BusinessHour オブジェクトを作成しています。そして、土曜日である date に offset を適用すると、次のビジネスデーである月曜日 (2023-12-26) が返されます。

weekmask は、曜日を表す文字列の組み合わせで指定します。使用可能な文字列は以下の通りです。

• Mon: 月曜日
• Tue: 火曜日
• Wed: 水曜日
• Thu: 木曜日
• Fri: 金曜日
• Sat: 土曜日
• Sun: 日曜日

これらの文字列を任意の順序で組み合わせて使用することができます。

その他のオプション

BusinessHour オブジェクトには、weekmask 以外にも、以下のオプションを指定することができます。

• start: 営業開始時間
• end: 営業終了時間
• holidays: 祝日

これらのオプションの詳細については、pandas ドキュメント: https://pandas.pydata.org/pandas-docs/stable/reference/api/pandas.tseries.offsets.BusinessHour.html を参照してください。

pandas.tseries.offsets.BusinessHour.weekmask は、BusinessHour オブジェクトを使用して、曜日ごとにビジネスデーとして扱われるかどうかを指定するための属性です。デフォルトでは月曜日から金曜日までの営業日がビジネスデーとなりますが、weekmask を使用して、この設定を変更することができます。

pandas.tseries.offsets.BusinessHour.weekmask サンプルコード

import pandas as pd

# 週末をビジネスデーとして設定
weekmask = 'Sat Sun'

# BusinessHour オブジェクトを作成
offset = pd.tseries.offsets.BusinessHour(weekmask=weekmask)

# 日付に BusinessHour オフセットを適用
date = pd.to_datetime('2023-12-24')  # 土曜日
new_date = date + offset

print(new_date)
# 出力: 2023-12-24

特定の曜日をビジネスデーとして除外する

import pandas as pd

# 水曜日をビジネスデーから除外
weekmask = 'Mon Tue Thu Fri'

# BusinessHour オブジェクトを作成
offset = pd.tseries.offsets.BusinessHour(weekmask=weekmask)

# 日付に BusinessHour オフセットを適用
date = pd.to_datetime('2023-12-27')  # 水曜日
new_date = date + offset

print(new_date)
# 出力: 2023-12-29

営業時間を設定する

import pandas as pd

# 営業時間を 9:00 から 18:00 に設定
start = pd.to_datetime('09:00')
end = pd.to_datetime('18:00')

# BusinessHour オブジェクトを作成
offset = pd.tseries.offsets.BusinessHour(start=start, end=end)

# 日付に BusinessHour オフセットを適用
date = pd.to_datetime('2023-12-24')  # 土曜日
new_date = date + offset

print(new_date)
# 出力: 2023-12-26 09:00:00

祝日を指定する

import pandas as pd

# 祝日を設定
holidays = ['2023-12-25', '2023-12-31']

# BusinessHour オブジェクトを作成
offset = pd.tseries.offsets.BusinessHour(holidays=holidays)

# 日付に BusinessHour オフセットを適用
date = pd.to_datetime('2023-12-25')  # クリスマス
new_date = date + offset

print(new_date)
# 出力: 2023-12-26

営業日数を計算する

import pandas as pd

# 2023年12月24日から2024年1月10日までの営業日数を計算
start_date = pd.to_datetime('2023-12-24')
end_date = pd.to_datetime('2024-01-10')

# BusinessHour オブジェクトを作成
offset = pd.tseries.offsets.BusinessHour()

# 営業日数を計算
business_days = (end_date - start_date) / offset

print(business_days)
# 出力: 12.0

これらのサンプルコードは、pandas.tseries.offsets.BusinessHour.weekmask 属性の使用方法を理解するのに役立ちます。

pandas.tseries.offsets.BusinessHour.weekmask 以外の方法

自作関数を使用する

import pandas as pd

def is_business_day(date):
  # 曜日を取得
  weekday = date.weekday()

  # 月曜日から金曜日までをビジネスデーとする
  return weekday >= 0 and weekday <= 4

# 日付にオフセットを適用
date = pd.to_datetime('2023-12-24')  # 土曜日
new_date = date + pd.offsets.Day()

while not is_business_day(new_date):
  new_date += pd.offsets.Day()

print(new_date)
# 出力: 2023-12-26

pandas.DateOffset を使用する

import pandas as pd

# 月曜日から金曜日までの営業日を表す DateOffset を作成
offset = pd.DateOffset(weekday=0, n=1)

# 日付にオフセットを適用
date = pd.to_datetime('2023-12-24')  # 土曜日
new_date = date + offset

print(new_date)
# 出力: 2023-12-26

外部ライブラリを使用する

holidays ライブラリなどの外部ライブラリを使用して、祝日などの情報を考慮した上で、曜日ごとにビジネスデーとして扱われるかどうかを指定することができます。

import pandas as pd
from holidays import USFederalHolidays

# 米国の祝日を取得
holidays = USFederalHolidays()

def is_business_day(date):
  # 曜日を取得
  weekday = date.weekday()

  # 月曜日から金曜日までをビジネスデーとする
  return weekday >= 0 and weekday <= 4 and date not in holidays

# 日付にオフセットを適用
date = pd.to_datetime('2023-12-25')  # クリスマス
new_date = date + pd.offsets.Day()

while not is_business_day(new_date):
  new_date += pd.offsets.Day()

print(new_date)
# 出力: 2023-12-26

これらの方法は、それぞれ異なる利点と欠点があります。自作関数は最も柔軟ですが、コード量が多くなります。pandas.DateOffset はシンプルですが、祝日などの情報を考慮できません。外部ライブラリは、祝日などの情報を考慮できますが、ライブラリのインストールが必要となります。