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

CustomBusinessHourオフセットが正規化（normalize）されているかどうかを確認するには、Pandasの CustomBusinessHour.normalize プロパティを使用します。このプロパティは、オフセット作成時に「normalize」パラメータが指定されているかどうかを真偽値で返します。

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

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

import pandas as pd

タイムスタンプの設定

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

timestamp = pd.Timestamp('2021-10-25 08:35:10')

CustomBusinessHourオフセットの作成

次に、CustomBusinessHourオフセットを作成します。CustomBusinessHourはDateOffsetのサブクラスであり、営業時間に基づいた日時の計算を行うことができます。ここでは、「normalize」パラメータを使用して正規化を有効にしています。

cbhOffset = pd.tseries.offsets.CustomBusinessHour(n = 3, weekmask = 'Mon Tue Wed Fri Sat', normalize=True)

「weekmask」パラメータには有効な営業日を指定します。この例では、月曜・火曜・水曜・金曜・土曜が営業日として設定されています。

オフセットの適用と結果の表示

タイムスタンプにオフセットを加算し、更新されたタイムスタンプを表示します。

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

そして、CustomBusinessHourオフセットが正規化されているかどうかを確認します。

print("\nThe CustomBusinessHour Offset is normalized ?\n", cbhOffset.normalize)

完全なコード例

以下に全体のコードを示します。

import pandas as pd

# タイムスタンプオブジェクトを設定
timestamp = pd.Timestamp('2021-10-25 08:35:10')

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

# CustomBusinessHourオフセットを作成
# CustomBusinessHourはDateOffsetのサブクラス
# weekmaskで有効な営業日を指定
# 「normalize」パラメータで正規化を有効化
cbhOffset = pd.tseries.offsets.CustomBusinessHour(n = 3, weekmask = 'Mon Tue Wed Fri Sat', normalize=True)

# CustomBusinessHourオフセットを表示
print("\nCustomBusinessHour Offset...\n", cbhOffset)

# オフセットを適用した更新後のタイムスタンプを表示
print("\nUpdated Timestamp...\n", timestamp + cbhOffset)

# 適用されている頻度を文字列として返す
print("\nFrequency applied on the given CustomBusinessHour Offset object...\n", cbhOffset.freqstr)

# 頻度の名前を返す
print("\nThe name of the frequency on the CustomBusinessHour object..\n", cbhOffset.name)

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

実行結果

上記のコードを実行すると、以下の出力が得られます。

Timestamp...
 2021-10-25 08:35:10

CustomBusinessHour Offset...
 <3 * CustomBusinessHours: CBH=09:00-17:00>

Updated Timestamp...
 2021-10-25 00:00:00

Frequency applied on the given CustomBusinessHour Offset object...
 3CBH

The name of the frequency on the CustomBusinessHour object..
 CBH

The CustomBusinessHour Offset is normalized ?
 True

解説

実行結果からわかるように、normalize=True を指定してCustomBusinessHourオフセットを作成したため、cbhOffset.normalize プロパティは True を返します。また、normalizeが有効になっているため、元のタイムスタンプ「2021-10-25 08:35:10」にオフセットを適用すると、時刻部分がリセットされ「2021-10-25 00:00:00」という日付の始まりの時刻に正規化されています。もしnormalizeを指定しなければ、Falseが返され、時刻もそのまま維持されます。