Python Pandas入門：DateTimeIndex.snap()でタイムスタンプを最も近い頻度にスナップする方法

DateTimeIndex.snap()メソッドとは

PandasのDateTimeIndex.snap()メソッドを使うと、DateTimeIndex内の各タイムスタンプを、指定した頻度の中で最も近い日時へスナップ（丸め）できます。スナップ先の頻度は、freqパラメータで指定します。

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

import pandas as pd

次に、期間6・頻度「D」（日単位）・タイムゾーン「Australia/Adelaide」を指定してDatetimeIndexを作成します。

datetimeindex = pd.date_range('2021-10-20 02:30:50', periods=6, tz='Australia/Adelaide', freq='D')

作成したDateTimeIndexを表示します。

print("DateTimeIndex...\n", datetimeindex)

続いて、タイムスタンプを最も近い月末日へスナップします。ここではfreqに「M」を指定しています。

print("\nSnap time stamps to nearest occurring frequency...\n",
datetimeindex.snap(freq='M'))

サンプルコード全体

以下が完全なコード例です。

import pandas as pd

# 期間6・頻度D（日単位）のDatetimeIndexを作成
# タイムゾーンは Australia/Adelaide を指定
datetimeindex = pd.date_range('2021-10-20 02:30:50', periods=6, tz='Australia/Adelaide', freq='D')

# DateTimeIndexを表示
print("DateTimeIndex...\n", datetimeindex)

# DateTimeIndexの頻度を表示
print("\nDateTimeIndex frequency...\n", datetimeindex.freq)

# タイムスタンプを最も近い月末日にスナップ
print("\nSnap time stamps to nearest occurring frequency...\n",
datetimeindex.snap(freq='M'))

実行結果

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

DateTimeIndex...
DatetimeIndex(['2021-10-20 02:30:50+10:30', '2021-10-21 02:30:50+10:30',
'2021-10-22 02:30:50+10:30', '2021-10-23 02:30:50+10:30',
'2021-10-24 02:30:50+10:30', '2021-10-25 02:30:50+10:30'],
dtype='datetime64[ns, Australia/Adelaide]', freq='D')
DateTimeIndex frequency...
<Day>

Snap time stamps to nearest occurring frequency...
DatetimeIndex(['2021-10-31 02:30:50+10:30', '2021-10-31 02:30:50+10:30',
'2021-10-31 02:30:50+10:30', '2021-10-31 02:30:50+10:30',
'2021-10-31 02:30:50+10:30', '2021-10-31 02:30:50+10:30'],
dtype='datetime64[ns, Australia/Adelaide]', freq=None)

ポイントのまとめ

• snap(freq=...)は、元のタイムスタンプを変更せず、新しいDatetimeIndexを返します。
• この例ではすべての日付が10月中のため、全タイムスタンプが2021-10-31（月末日）にスナップされています。
• スナップ後のインデックスはfreq=Noneになる点に注意してください。規則的な頻度情報は保持されません。
• freqには「M」（月末）以外にも、「B」（営業日）や「W」（週次）など、Pandasで利用可能なオフセットエイリアスを指定できます。