Pandas Data Offsets と BusinessMonthBegin を徹底解説！

Pandas Data Offsets と BusinessMonthBegin.freqstr

BusinessMonthBegin は、月初めの営業日を表すオフセットです。freqstr 属性は、このオフセットを 文字列形式で取得 するためのものです。

BusinessMonthBegin.freqstr は、以下の形式で文字列を返します。

'BM'

• B は Business を意味します。
• M は Month を意味します。

例:

import pandas as pd

offset = pd.offsets.BusinessMonthBegin()

print(offset.freqstr)

出力:

BM

BusinessMonthBegin を使用した日付の操作

BusinessMonthBegin オフセットを使用して、日付を月初めの営業日に移動することができます。

例:

import pandas as pd

date = pd.to_datetime('2023-12-31')

# 2024年1月1日 (月曜日) は営業日ではないため、
# 次の営業日である2024年1月2日 (火曜日) に移動する

new_date = date + offset

print(new_date)

出力:

2024-01-02

BusinessMonthBegin の注意点

• BusinessMonthBegin オフセットは、週末や祝日 を考慮します。
• 特定の 祝日を営業日として扱う こともできます。

• pandas.tseries.offsets.BusinessMonthBegin.freqstr は、月初めの営業日を表すオフセットを文字列形式で取得するための属性です。
• BusinessMonthBegin オフセットを使用して、日付を月初めの営業日に移動することができます。
• BusinessMonthBegin オフセットを使用する際には、週末や祝日、および特定の祝日を営業日として扱うかどうかを考慮する必要があります。

Pandas Data Offsets と BusinessMonthBegin を使ったサンプルコード

BusinessMonthBegin オフセットを使用して、月初めの営業日を取得する

import pandas as pd

# 2023年12月31日の月初めの営業日を取得する

date = pd.to_datetime('2023-12-31')
offset = pd.offsets.BusinessMonthBegin()

new_date = date + offset

print(new_date)

2024-01-02

BusinessMonthBegin オフセットを使用して、日付範囲を生成する

import pandas as pd

# 2023年12月から2024年11月までの月初めの営業日のリストを生成する

start_date = pd.to_datetime('2023-12-01')
end_date = pd.to_datetime('2024-11-01')

dates = pd.date_range(start_date, end_date, freq='BM')

print(dates)

出力:

DatetimeIndex(['2023-12-01', '2024-01-02', '2024-02-01', '2024-03-01',
               '2024-04-02', '2024-05-01', '2024-06-03', '2024-07-02',
               '2024-08-01', '2024-09-03', '2024-10-01', '2024-11-01'],
              dtype='datetime64[ns]', freq='BM')

特定の祝日を営業日として扱う

import pandas as pd

# 2023年1月1日 (元日) を営業日として扱う

holidays = pd.to_datetime(['2023-01-01'])

offset = pd.offsets.BusinessMonthBegin(holidays=holidays)

# 2023年12月31日の月初めの営業日を取得する

date = pd.to_datetime('2023-12-31')

new_date = date + offset

print(new_date)

出力:

2024-01-01

• 上記のコードはほんの一例です。
• Pandas Data Offsets と BusinessMonthBegin を使用して、さまざまな日付操作を行うことができます。

Pandas で月初めの営業日を取得する他の方法

groupby と head を使用する方法

import pandas as pd

# データフレームを作成する

df = pd.DataFrame({'Date': pd.date_range('2023-12-01', '2024-11-01')})

# 月ごとにグループ化し、最初の行を取得する

df = df.groupby(pd.Grouper(level='Date', freq='M'))['Date'].head(1)

print(df)

出力:

0   2023-12-01
1   2024-01-02
2   2024-02-01
3   2024-03-01
4   2024-04-02
5   2024-05-01
6   2024-06-03
7   2024-07-02
8   2024-08-01
9   2024-09-03
10  2024-10-01
11  2024-11-01

自作関数を使用する方法

import pandas as pd

def get_business_month_begin(date):
  """
  月初めの営業日を取得する関数

  Args:
    date: datetime 型の日付

  Returns:
    datetime 型の月初めの営業日
  """

  # 月の初めの日を取得する

  month_begin = pd.to_datetime(date).replace(day=1)

  # 営業日になるまで、1日ずつ加算していく

  while not pd.offsets.is_business_day(month_begin):
    month_begin += pd.Timedelta(days=1)

  return month_begin

# 2023年12月31日の月初めの営業日を取得する

date = pd.to_datetime('2023-12-31')

new_date = get_business_month_begin(date)

print(new_date)

出力:

2024-01-02

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

holidays などの外部ライブラリを使用することで、祝日などを考慮した月初めの営業日を取得することができます。

import pandas as pd
from holidays import USFederalHolidays

# 祝日を取得する

holidays = USFederalHolidays()

# 月初めの営業日を取得する

def get_business_month_begin(date):
  """
  月初めの営業日を取得する関数

  Args:
    date: datetime 型の日付

  Returns:
    datetime 型の月初めの営業日
  """

  # 月の初めの日を取得する

  month_begin = pd.to_datetime(date).replace(day=1)

  # 営業日になるまで、1日ずつ加算していく

  while not pd.offsets.is_business_day(month_begin, holidays=holidays):
    month_begin += pd.Timedelta(days=1)

  return month_begin

# 2023年12月31日の月初めの営業日を取得する

date = pd.to_datetime('2023-12-31')

new_date = get_business_month_begin(date)

print(new_date)

出力:

2024-01-02

• pandas.tseries.offsets.BusinessMonthBegin 以外にも、月初めの営業日を取得する方法はいくつかあります。
• どの方法を使用するかは、状況によって異なります。
• 複数の方法を比較して、最適な方法を選択してください。