Python Pandas入門：DateOffset値が正規化（normalize）されているかどうかを確認する方法

PandasでDateOffsetオフセット値が正規化（normalize）されているかどうかを確認するには、offset.normalize プロパティを使用します。このプロパティは、DateOffsetオブジェクトの作成時に normalize=True が指定されているかどうかをブール値（True / False）で返します。

DateOffsetの正規化確認の手順

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

from pandas.tseries.offsets import DateOffset
import pandas as pd

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

timestamp = pd.Timestamp('2021-09-26 03:25:02.000045')

次に、DateOffsetを作成します。ここでは「months」パラメータを使用して月数を加算しています。さらに、「normalize」パラメータにTrueを指定することで、DateOffsetを正規化しています。

offset = pd.tseries.offsets.DateOffset(months=4, normalize=True)

更新されたタイムスタンプを表示します。

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

DateOffsetが正規化されているかどうかを確認します。

print("\nThe DateOffset is normalized..\n", offset.normalize)

サンプルコード

以下に完全なコード例を示します。

from pandas.tseries.offsets import DateOffset
import pandas as pd

# Pandasでタイムスタンプオブジェクトを設定
timestamp = pd.Timestamp('2021-09-26 03:25:02.000045')

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

# DateOffsetを作成
# 「months」パラメータで月数を加算
# 「normalize」パラメータでDateOffsetを正規化
offset = pd.tseries.offsets.DateOffset(months=4, normalize=True)

# DateOffsetを表示
print("\nDateOffset...\n", offset)

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

# DateOffsetが正規化されているかどうかを確認
print("\nThe DateOffset is normalized..\n", offset.normalize)

実行結果

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

Timestamp...
 2021-09-26 03:25:02.000045

DateOffset...
 <DateOffset: months=4>

Updated Timestamp...
 2022-01-26 00:00:00

The DateOffset is normalized..
 True

ポイント解説

normalize=True を指定した場合、タイムスタンプにDateOffsetを加算すると、時刻部分が午前0時（00:00:00）に丸められます。上記の出力を見ると、元のタイムスタンプは「03:25:02.000045」という時刻を持っていましたが、更新後のタイムスタンプは「2022-01-26 00:00:00」となり、時刻情報がリセットされていることがわかります。

また、offset.normalize プロパティは True を返すため、このDateOffsetが正規化設定になっていることが確認できます。normalize=False（デフォルト）の場合は、時刻部分はそのまま保持されます。