Python Pandas入門：指定したDateOffsetがアンカー付きかどうかを確認する方法

Pandasでは、指定したDateOffset（日付オフセット）がアンカー付きであるかどうかを簡単に確認できます。アンカー付きオフセットとは、「毎週火曜日」のように特定の曜日や時点に固定された頻度を持つオフセットのことです。確認には is_anchored() メソッドを使用します。

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

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

from pandas.tseries.frequencies import to_offset
import pandas as pd

タイムスタンプの設定

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

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

DateOffsetの作成

次に、DateOffsetを作成します。ここでは、火曜日に固定された週次頻度「W-TUE」というアンカー付きオフセットを使用します。

offset = to_offset("W-TUE")

作成したオフセットを表示してみましょう。

print("\nDateOffset...\n", offset)

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

元のタイムスタンプにオフセットを加算すると、直近の火曜日へ移動した結果が得られます。

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

アンカー付きかどうかを確認

is_anchored() メソッドを呼び出すことで、そのDateOffsetがアンカー付きかどうかを真偽値（True / False）で確認できます。

print("\nCheck whether the DateOffset is anchored...\n", offset.is_anchored())

完全なコード例

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

from pandas.tseries.frequencies import to_offset
import pandas as pd

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

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

# DateOffsetを作成
# 火曜日に固定された週次頻度（アンカー付きオフセット）を使用
offset = to_offset("W-TUE")

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

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

# DateOffsetがアンカー付きかどうかを確認
print("\nCheck whether the DateOffset is anchored...\n", offset.is_anchored())

実行結果

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

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

DateOffset...
 <Week: weekday=1>

Updated Timestamp...
 2021-09-28 03:25:02.000045

Check whether the DateOffset is anchored...
 True

まとめ

このように、to_offset() で生成したオフセットに対して is_anchored() を呼び出すだけで、そのオフセットが特定の時点（曜日など）に固定されているかどうかを判定できます。今回の例では W-TUE（火曜日の週次頻度）はアンカー付きのため、結果は True となりました。なお、2021年9月26日は日曜日だったため、オフセット適用後の日付は直近の火曜日である9月28日に移動しています。