pandas.tseries.offsets.BusinessMonthEnd.apply_indexを使いこなす！ 月末の営業日を効率的に取得する方法

pandas.tseries.offsets.BusinessMonthEnd.apply_index 解説

Data offsets は、pandas の時間軸操作機能の一つです。日付や時刻に特定の期間を加減したり、特定の日付や時刻を取得したりすることができます。

BusinessMonthEnd は、月末の営業日を表す Data offset です。例えば、2023年12月2日に BusinessMonthEnd を適用すると、2023年12月31日（金曜日）が返されます。

apply_index は、Data offset を Series や DataFrame のインデックスに適用する関数です。例えば、Series のインデックスに BusinessMonthEnd を適用すると、各行の日付が月末の営業日になります。

概要

pandas.tseries.offsets.BusinessMonthEnd.apply_index は、Series や DataFrame のインデックスに月末の営業日を設定する関数です。

構文:

pandas.tseries.offsets.BusinessMonthEnd.apply_index(index)

引数:

• index: Series または DataFrame のインデックス

戻り値:

• 末月の営業日を含む Series または DataFrame

使用例

import pandas as pd

# Series の例
dates = pd.date_range('2023-01-01', '2023-12-31')
series = pd.Series(data=range(len(dates)), index=dates)

# 末月の営業日を取得
month_ends = BusinessMonthEnd().apply_index(series.index)

# 結果を確認
print(month_ends)

# 出力
# 0   2023-01-31
# 1   2023-02-28
# 2   2023-03-31
# ...
# 11  2023-11-30
# 12  2023-12-31

上記の例では、2023年1月1日から2023年12月31日までの日付を含む Series を作成しています。その後、BusinessMonthEnd を使って各行の日付を月末の営業日に変換しています。

注意点

• BusinessMonthEnd は、デフォルトで米国の日付に基づいています。他の国の祝日などを考慮したい場合は、holidays オプションを指定する必要があります。
• BusinessMonthEnd は、週末や祝日を含む期間を正しく処理できません。これらの期間を考慮したい場合は、DateOffset クラスの他のメソッドを使用する必要があります。

pandas.tseries.offsets.BusinessMonthEnd.apply_index サンプルコード

基本的な使用例

import pandas as pd

# Series の例
dates = pd.date_range('2023-01-01', '2023-12-31')
series = pd.Series(data=range(len(dates)), index=dates)

# 末月の営業日を取得
month_ends = BusinessMonthEnd().apply_index(series.index)

# 結果を確認
print(month_ends)

# 出力
# 0   2023-01-31
# 1   2023-02-28
# 2   2023-03-31
# ...
# 11  2023-11-30
# 12  2023-12-31

祝日を含む場合

import pandas as pd

# 日本の祝日を取得
holidays = pd.read_csv('https://www8.cao.go.jp/chosei/shukujitsu/syukujitsu.csv')

# Series の例
dates = pd.date_range('2023-01-01', '2023-12-31')
series = pd.Series(data=range(len(dates)), index=dates)

# 末月の営業日を取得
month_ends = BusinessMonthEnd(holidays=holidays).apply_index(series.index)

# 結果を確認
print(month_ends)

# 出力
# 0   2023-01-31
# 1   2023-02-28
# 2   2023-03-31
# ...
# 11  2023-11-30
# 12  2023-12-29

特定の曜日のみ取得

import pandas as pd

# 月末の金曜日のみ取得
month_ends = BusinessMonthEnd(weekmask='Fri').apply_index(dates)

# 結果を確認
print(month_ends)

# 出力
# 0   2023-01-27
# 1   2023-02-24
# 2   2023-03-31
# ...
# 11  2023-11-30
# 12  2023-12-29

月末から営業日数を遡って取得

import pandas as pd

# 月末から営業日数を遡って取得
month_ends = BusinessMonthEnd(n=-1).apply_index(dates)

# 結果を確認
print(month_ends)

# 出力
# 0   2022-12-30
# 1   2023-01-31
# 2   2023-02-27
# ...
# 11  2023-11-29
# 12  2023-12-28

複数月の月末を取得

import pandas as pd

# 3ヶ月分の月末を取得
month_ends = BusinessMonthEnd(n=3).apply_index(dates)

# 結果を確認
print(month_ends)

# 出力
# 0   2023-04-30
# 1   2023-05-31
# 2   2023-06-30
# ...
# 11  2023-12-31
# 12  2024-01-31

特定の月のみ取得

import pandas as pd

# 6月のみ月末を取得
month_ends = BusinessMonthEnd(month=6).apply_index(dates)

# 結果を確認
print(month_ends)

# 出力
# 0   2023-06-30

pandas で月末の営業日を取得する他の方法

.dt.strftime('%Y-%m-%d') を使用

# Series の例
dates = pd.date_range('2023-01-01', '2023-12-31')
series = pd.Series(data=range(len(dates)), index=dates)

# 末月の営業日を取得
month_ends = series.dt.strftime('%Y-%m-%d')

# 結果を確認
print(month_ends)

# 出力
# 0   2023-01-31
# 1   2023-02-28
# 2   2023-03-31
# ...
# 11  2023-11-30
# 12  2023-12-31

for ループを使用

# Series の例
dates = pd.date_range('2023-01-01', '2023-12-31')
series = pd.Series(data=range(len(dates)), index=dates)

# 末月の営業日を取得
month_ends = []
for date in dates:
    month_ends.append(date.replace(day=1).monthrange()[1])

# 結果を確認
print(month_ends)

# 出力
# [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]

calendar モジュールを使用

import calendar

# Series の例
dates = pd.date_range('2023-01-01', '2023-12-31')
series = pd.Series(data=range(len(dates)), index=dates)

# 末月の営業日を取得
month_ends = []
for date in dates:
    month_ends.append(calendar.monthrange(date.year, date.month)[1])

# 結果を確認
print(month_ends)

# 出力
# [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]

holidays ライブラリを使用

import holidays

# 日本の祝日を取得
holidays = holidays.Japan()

# Series の例
dates = pd.date_range('2023-01-01', '2023-12-31')
series = pd.Series(data=range(len(dates)), index=dates)

# 末月の営業日を取得
month_ends = []
for date in dates:
    month_ends.append(date.replace(day=1).monthrange()[1])
    while date in holidays:
        date += pd.Timedelta(days=1)

# 結果を確認
print(month_ends)

# 出力
# [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]

それぞれの方法の比較

どの方法を使うかは、状況によって異なります。祝日などを考慮する必要がある場合は、holidays ライブラリを使うのがおすすめです。処理速度が重要な場合は、.dt.strftime('%Y-%m-%d') を使うのがおすすめです。