Pandasで営業日オフセットを扱う： BusinessHour.normalize 完全解説

pandas.tseries.offsets.BusinessHour.normalizeは、BusinessHourオフセットを正規化するために使用されます。これは、オフセットが営業日の開始時刻に丸められることを意味します。

引数

• normalize: Trueの場合、オフセットは営業日の開始時刻に丸められます。Falseの場合、オフセットは変更されません。

戻り値

• 正規化されたBusinessHourオフセット

例

from pandas.tseries.offsets import BusinessHour

# 営業日の開始時刻が9:00のオフセットを作成
offset = BusinessHour(start='09:00')

# 2023-03-08 15:00にオフセットを追加
timestamp = pd.Timestamp('2023-03-08 15:00') + offset

# 結果は2023-03-09 09:00になる
print(timestamp)

出力

2023-03-09 09:00:00

詳細

BusinessHour.normalizeは、normalize属性を使用してデフォルトで有効になっています。つまり、BusinessHourオフセットを追加すると、オフセットは通常、営業日の開始時刻に丸められます。

ただし、normalize属性をFalseに設定すると、オフセットは丸められません。これは、オフセットが特定の時刻を表す必要がある場合に役立ちます。

• BusinessHour.normalizeは、BusinessDayオフセットにも使用できます。
• normalize属性を使用して、他のDateOffsetサブクラスの動作を変更することもできます。

pandas.tseries.offsets.BusinessHour.normalizeについて質問がある場合は、お気軽にコメントしてください。

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

サンプルコード1：営業日の開始時刻に丸める

from pandas.tseries.offsets import BusinessHour

# 営業日の開始時刻が9:00のオフセットを作成
offset = BusinessHour(start='09:00')

# 2023-03-08 15:00にオフセットを追加
timestamp = pd.Timestamp('2023-03-08 15:00') + offset

# 結果は2023-03-09 09:00になる
print(timestamp)

出力

2023-03-09 09:00:00

サンプルコード2：オフセットを丸めない

from pandas.tseries.offsets import BusinessHour

# 営業日の開始時刻が9:00のオフセットを作成
offset = BusinessHour(start='09:00', normalize=False)

# 2023-03-08 15:00にオフセットを追加
timestamp = pd.Timestamp('2023-03-08 15:00') + offset

# 結果は2023-03-08 15:00になる
print(timestamp)

出力

2023-03-08 15:00:00

サンプルコード3：祝日の処理

from pandas.tseries.offsets import BusinessHour

# 祝日リストを作成
holidays = pd.to_datetime(['2023-03-09', '2023-03-10'])

# 営業日の開始時刻が9:00、祝日を除外するオフセットを作成
offset = BusinessHour(start='09:00', holidays=holidays)

# 2023-03-08 15:00にオフセットを追加
timestamp = pd.Timestamp('2023-03-08 15:00') + offset

# 結果は2023-03-11 09:00になる
print(timestamp)

出力

2023-03-11 09:00:00

サンプルコード4：複数営業日分のオフセット

from pandas.tseries.offsets import BusinessHour

# 2営業日分のオフセットを作成
offset = BusinessHour(n=2)

# 2023-03-08 15:00にオフセットを追加
timestamp = pd.Timestamp('2023-03-08 15:00') + offset

# 結果は2023-03-13 09:00になる
print(timestamp)

出力

2023-03-13 09:00:00

• これらのサンプルコードは、pandas.tseries.offsets.BusinessHour.normalizeの使い方を理解するのに役立ちます。
• さまざまな引数と設定を使用して、独自のサンプルコードを作成できます。
• pandasドキュメントには、BusinessHourオフセットに関する詳細情報が記載されています。

pandas.tseries.offsets.BusinessHour.normalizeについて質問がある場合は、お気軽にコメントしてください。

pandas.tseries.offsets.BusinessHour.normalize の代替方法

方法1：floorメソッドを使用する

from pandas.tseries.offsets import BusinessHour

# 営業日の開始時刻が9:00のオフセットを作成
offset = BusinessHour(start='09:00')

# 2023-03-08 15:00にオフセットを追加
timestamp = pd.Timestamp('2023-03-08 15:00') + offset

# 営業日の開始時刻に丸める
timestamp = timestamp.floor('D')

# 結果は2023-03-09 00:00:00になる
print(timestamp)

出力

2023-03-09 00:00:00

方法2：shiftメソッドを使用する

from pandas.tseries.offsets import BusinessHour

# 営業日の開始時刻が9:00のオフセットを作成
offset = BusinessHour(start='09:00')

# 2023-03-08 15:00にオフセットを追加
timestamp = pd.Timestamp('2023-03-08 15:00') + offset

# 営業日の開始時刻までシフトする
timestamp = timestamp.shift(freq='BDay', n=-1)

# 結果は2023-03-09 09:00:00になる
print(timestamp)

出力

2023-03-09 09:00:00

方法3：カスタム関数を使用する

def normalize_business_hour(timestamp, start='09:00'):
  """
  営業日の開始時刻に丸める

  Args:
    timestamp: 時刻
    start: 営業日の開始時刻

  Returns:
    営業日の開始時刻に丸められた時刻
  """

  # 営業日の開始時刻を取得
  start_time = pd.Timestamp(start).time()

  # 時刻を午前0時0分に設定
  timestamp = timestamp.replace(hour=0, minute=0, second=0, microsecond=0)

  # 営業日の開始時刻まで差分を計算
  delta = timestamp - start_time

  # 営業日の開始時刻に丸める
  if delta < pd.Timedelta(0):
    timestamp -= delta
  else:
    timestamp += pd.Timedelta(days=1) - delta

  return timestamp

# 2023-03-08 15:00にオフセットを追加
timestamp = pd.Timestamp('2023-03-08 15:00')

# 営業日の開始時刻に丸める
timestamp = normalize_business_hour(timestamp)

# 結果は2023-03-09 09:00:00になる
print(timestamp)

出力

2023-03-09 09:00:00

比較

pandas.tseries.offsets.BusinessHour.normalize は、BusinessHour オフセットを営業日の開始時刻に丸めるための簡単な方法です。しかし、他の方法もいくつかあり、それぞれメリットとデメリットがあります。状況に合わせて最適な方法を選択してください。

pandas.tseries.offsets.BusinessHour.normalize