Python Pandas – 指定したBusinessHourオフセットオブジェクトに適用された頻度の名前を返す方法

指定したBusinessHourオフセットオブジェクトに適用されている頻度（frequency）の名前を取得するには、PandasのBusinessHour.nameプロパティを使用します。この記事では、具体的なコード例とともにその使い方を解説します。

必要なライブラリのインポート

まず、必要なライブラリをインポートします。

import pandas as pd

タイムスタンプの作成

Pandasでタイムスタンプオブジェクトを設定します。

timestamp = pd.Timestamp('2021-1-1 01:55:30')

BusinessHourオフセットの作成

次に、BusinessHourオフセットを作成します。BusinessHourはDateOffsetクラスのサブクラスであり、営業時間に基づいた日付の計算を行うために使用されます。

• start：カスタム営業時間の開始時刻（24時間形式）
• end：カスタム営業時間の終了時刻（24時間形式）

bhOffset = pd.tseries.offsets.BusinessHour(start="09:30", end = "18:00")

更新後のタイムスタンプの表示

タイムスタンプにBusinessHourオフセットを加算した結果を表示します。

print("\nUpdated Timestamp...\n",timestamp + bhOffset)

頻度の名前を取得する

指定したBusinessHourオブジェクトに適用されている頻度の名前を返します。nameプロパティにアクセスするだけで、そのオフセットが表す頻度の文字列（ここでは「BH」）を取得できます。

print("\nThe name of the frequency on the BusinessHour object..\n", bhOffset.name)

完全なコード例

以下は、これまでの手順をまとめた完全なサンプルコードです。

import pandas as pd

# Pandasでタイムスタンプオブジェクトを設定
timestamp = pd.Timestamp('2021-1-1 01:55:30')

# タイムスタンプを表示
print("Timestamp...\n",timestamp)

# BusinessHourオフセットを作成
# BusinessHourはDateOffsetのサブクラス
# 「start」はカスタム営業時間の開始時刻（24時間形式）
# 「end」はカスタム営業時間の終了時刻（24時間形式）
bhOffset = pd.tseries.offsets.BusinessHour(start="09:30", end = "18:00")

# BusinessHourオフセットを表示
print("\nBusinessHour Offset...\n",bhOffset)

# 更新後のタイムスタンプを表示
print("\nUpdated Timestamp...\n",timestamp + bhOffset)

# 指定したBusinessHourオブジェクトに適用された頻度の名前を返す
print("\nThe name of the frequency on the BusinessHour object..\n", bhOffset.name)

出力結果

上記のコードを実行すると、次のような出力が得られます。

Timestamp...
 2021-01-01 01:55:30

BusinessHour Offset...
 <BusinessHour: BH=09:30-18:00>

Updated Timestamp...
 2021-01-01 10:30:00

The name of the frequency on the BusinessHour object..
 BH

まとめ

このように、BusinessHour.nameプロパティを使うことで、BusinessHourオフセットオブジェクトに適用された頻度の名前を簡単に確認できます。出力結果からも分かるように、デフォルトの営業時間設定の場合は「BH」という名前が返され、タイムスタンプへの加算結果も営業時間内の時刻（10:30:00）になっていることが確認できます。