Python Pandas – BusinessHourオフセットが正規化されているか確認する方法

Pandasでは、BusinessHour.normalizeプロパティを使用することで、BusinessHourオフセットが正規化（normalize）されているかどうかを簡単に確認できます。この記事では、具体的なコード例とともにその手順を解説します。

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

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

import pandas as pd

タイムスタンプの設定

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

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

BusinessHourオフセットの作成

BusinessHourオフセットを作成します。ここでは「normalize」パラメータを使って、BusinessHourを正規化しています。

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

補足：BusinessHourはDateOffsetのサブクラスです。「start」はカスタム営業時間の開始時刻、「end」は終了時刻を24時間形式で指定します。

更新されたタイムスタンプの表示

オフセット適用後のタイムスタンプを表示します。

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

正規化されているかどうかの確認

BusinessHourオフセットが正規化されているかどうかをチェックします。

print("\nThe BusinessHour Offset is normalized ?\n", bhOffset.normalize)

完全なコード例

以下に、これまでの手順をまとめた完全なコードを示します。

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時間形式）
# 「normalize」パラメータでBusinessHourを正規化
bhOffset = pd.tseries.offsets.BusinessHour(start="09:30", end = "18:00", normalize=True)

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

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

# BusinessHourオフセットが正規化されているかどうかを確認
print("\nThe BusinessHour Offset is normalized ?\n", bhOffset.normalize)

実行結果

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

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

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

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

The BusinessHour Offset is normalized ?
 True

出力結果からわかるように、bhOffset.normalizeはTrueを返しており、BusinessHourオフセットが正規化されていることが確認できます。また、正規化によって更新後のタイムスタンプの時刻部分が「00:00:00」に丸められている点にも注目してください。