Python Pandas入門：CustomBusinessHourがアンカーされているかどうかを確認する方法

指定されたCustomBusinessHour（カスタム営業時間オフセット）がアンカー（固定）されているかどうかを確認するには、PandasのCustomBusinessHour.is_anchored()メソッドを使用します。このメソッドは、オフセットが特定の時刻に固定されている場合にTrueを返します。

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

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

import pandas as pd

タイムスタンプの作成

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

timestamp = pd.Timestamp('2021-11-14 05:20:30')

CustomBusinessHourオフセットの作成

次に、CustomBusinessHourオフセットを作成します。CustomBusinessHourはDateOffsetのサブクラスであり、カスタマイズされた営業時間を表すことができます。ここでは、「start」パラメータで営業開始時刻を、「end」パラメータで営業終了時刻を24時間形式で指定しています。

cbhOffset = pd.tseries.offsets.CustomBusinessHour(start="09:30", end = "18:30")

タイムスタンプへのオフセット適用

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

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

アンカーされているかどうかの確認

CustomBusinessHourがアンカーされているかどうかを確認します。

print("\nCheck whether the CustomBusinessHour is anchored...\n", cbhOffset.is_anchored())

完全なコード例

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

import pandas as pd

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

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

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

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

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

# CustomBusinessHourがアンカーされているかどうかを確認
print("\nCheck whether the CustomBusinessHour is anchored...\n", cbhOffset.is_anchored())

実行結果

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

Timestamp...
 2021-11-14 05:20:30

CustomBusinessHour Offset...
 <CustomBusinessHour: CBH=09:30-18:30>

Updated Timestamp...
 2021-11-15 10:30:00

Check whether the CustomBusinessHour is anchored...
 True

解説

実行結果からわかるように、元のタイムスタンプ「2021-11-14 05:20:30」にCustomBusinessHourオフセット（09:30〜18:30）を適用すると、翌営業日の開始時刻である「2021-11-15 10:30:00」に更新されます。また、is_anchored()メソッドはTrueを返しており、このCustomBusinessHourオフセットがアンカー（固定）されていることが確認できます。これは、オフセットが特定の頻度単位（この場合は営業時間）に固定されていることを意味します。