Pandas Data Offsets: CustomBusinessDay.copy 関数を徹底解説

Pandas Data Offsets: pandas.tseries.offsets.CustomBusinessDay.copy を理解する

pandas.tseries.offsets.CustomBusinessDay.copy は、Pandas の Data Offsets 機能を使って、カスタムビジネスデイオフセットを複製するための関数です。これは、独自の営業日カレンダーに基づいて日付を操作する必要がある場合に役立ちます。

この解説で学ぶこと

• Data Offsets とは何か
• CustomBusinessDay オフセットとは何か
• CustomBusinessDay.copy 関数の使用方法
• 実際のコード例

Data Offsets は、Pandas の Time Series 機能の一部で、日付や時刻にオフセットを追加するためのツールです。デフォルトで用意されているオフセットには、以下のようなものがあります。

• Day：指定された日数を加算または減算
• BusinessDay：営業日数を加算または減算
• MonthEnd：月末へ移動
• YearBegin：年初へ移動

CustomBusinessDay オフセットは、独自の営業日カレンダーに基づいて日付を操作するために使用されます。このオフセットを作成するには、以下の情報を指定する必要があります。

• 週の営業日（月曜日から金曜日など）
• 祝日

CustomBusinessDay.copy 関数は、既存の CustomBusinessDay オフセットを複製するために使用されます。この関数は、以下の引数を受け取ります。

• holidays：祝日のリスト
• weekmask：営業日のマスク（月曜日から金曜日であれば 'Mon Tue Wed Thu Fri'）
• kwargs：その他のオプション引数

CustomBusinessDay.copy 関数のオプション

• holidays：デフォルトでは []。祝日のリストを指定できます。
• weekmask：デフォルトでは 'Mon Tue Wed Thu Fri'。営業日のマスクを指定できます。
• kwargs：以下のオプション引数を指定できます。
  • calendar：独自の営業日カレンダーオブジェクト
  • start：オフセットの開始日
  • end：オフセットの終了日

実際のコード例

from pandas.tseries.offsets import CustomBusinessDay

# 祝日と営業日のマスクを定義
holidays = ['2024-01-01', '2024-12-25']
weekmask = 'Mon Tue Wed Thu Fri'

# CustomBusinessDay オフセットを作成
bday_us = CustomBusinessDay(holidays=holidays, weekmask=weekmask)

# オフセットを複製
bday_us_copy = bday_us.copy()

# 複製したオフセットを使用して日付を操作
date = pd.to_datetime('2024-03-17')
next_business_day = date + bday_us_copy

print(next_business_day)

# 出力: 2024-03-18

まとめ

pandas.tseries.offsets.CustomBusinessDay.copy 関数は、独自の営業日カレンダーに基づいて日付を操作する必要がある場合に役立ちます。この関数は、既存の CustomBusinessDay オフセットを複製し、必要に応じてオプションを変更することができます。

いろいろなサンプルコード

# 方法 1: リストを使用
holidays = ['2024-01-01', '2024-12-25']
weekmask = 'Mon Tue Wed Thu Fri'

# 方法 2: Pandas DatetimeIndex を使用
holidays = pd.to_datetime(['2024-01-01', '2024-12-25'])
weekmask = pd.tseries.offsets.Day(1).to_business_day_mask()

# 方法 3: カレンダーオブジェクトを使用
from pandas.tseries.offsets import美國カレンダー

holidays = 미국カレンダー().holidays
weekmask = 미국カレンダー().weekmask

# CustomBusinessDay オフセットを作成
bday_us = CustomBusinessDay(holidays=holidays, weekmask=weekmask)

独自の営業日カレンダーオブジェクトを使用する

class MyCalendar(object):

    def __init__(self):
        self.holidays = ['2024-01-01', '2024-12-25']
        self.weekmask = 'Mon Tue Wed Thu Fri'

    def is_business_day(self, date):
        return date not in self.holidays and date.weekday() in self.weekmask

# CustomBusinessDay オフセットを作成
bday_my = CustomBusinessDay(calendar=MyCalendar())

オフセットの開始日と終了日を指定する

# 2024年3月17日から始まるオフセット
bday_us_start = CustomBusinessDay(holidays=holidays, weekmask=weekmask, start='2024-03-17')

# 2024年12月31日までに終了するオフセット
bday_us_end = CustomBusinessDay(holidays=holidays, weekmask=weekmask, end='2024-12-31')

Offsets を使用して日付を操作する

# 現在の日付を取得
date = pd.to_datetime('2024-03-17')

# 営業日数を加算
next_business_day = date + bday_us

# 営業日数を減算
previous_business_day = date - bday_us

# 特定の日付までの営業日数を計算
business_days_to_end_of_year = bday_us.apply(date, '2024-12-31')

# 特定の日付範囲の営業日数を計算
business_days_in_range = bday_us.apply(date, '2024-03-17', '2024-05-01')

これらのサンプルコードは、CustomBusinessDay.copy 関数の使用方法と、さまざまなオプションを理解するのに役立ちます。

その他の方法

pandas.tseries.offsets.DateOffset サブクラスを作成する

CustomBusinessDay オフセットは、DateOffset サブクラスです。独自の営業日カレンダーのロジックを実装する場合は、独自の DateOffset サブクラスを作成できます。

pandas.tseries.offsets.HolidayCalendar サブクラスを作成する

HolidayCalendar サブクラスは、祝日のリストを管理するためのツールです。独自の営業日カレンダーには、祝日だけでなく、その他の非営業日も含まれる場合があります。そのような場合は、独自の HolidayCalendar サブクラスを作成し、そのサブクラスを使用して CustomBusinessDay オフセットを作成できます。

自身の関数を作成する

上記のいずれの方法も適切でない場合は、独自の関数を作成して、独自の営業日カレンダーのロジックを実装できます。

ライブラリを使用する

独自の営業日カレンダーを処理する必要がある場合は、以下のライブラリが役立ちます。

質問

上記の方法について不明な点や、その他の方法について知りたい場合は、遠慮なく質問してください。