Python Pandas入門：floor()メソッドでTimedeltaをミリ秒単位に切り下げる方法

PandasでTimedeltaオブジェクトを指定した解像度に切り下げた（フロア処理した）新しい値を取得するには、timedelta.floor()メソッドを使用します。ミリ秒単位で切り下げたい場合は、freqパラメータに「ms」を指定します。

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

まず、pandasをインポートします。

import pandas as pd

Timedeltaオブジェクトの作成

TimeDeltasは、Pythonの標準datetimeライブラリにおけるtimedeltaの表現形式です。ここでは、日・時間・分・秒・ミリ秒・ナノ秒を含むTimedeltaオブジェクトを作成します。

timedelta = pd.Timedelta('2 days 10 hours 45 min 20 s 35 ms 55 ns')

Timedeltaの表示

作成したTimedeltaオブジェクトを表示して確認します。

print("Timedelta...\n", timedelta)

ミリ秒解像度へのフロア処理

floor()メソッドにfreq='ms'を渡すことで、ミリ秒より細かい単位（マイクロ秒・ナノ秒）が切り下げられた新しいTimedeltaを返します。

timedelta.floor(freq='ms')

完全なコード例

以下に、ここまでの手順をまとめたサンプルコードを示します。

import pandas as pd

# TimeDeltasはPython標準datetimeライブラリのtimedelta表現
# Timedeltaオブジェクトを作成
timedelta = pd.Timedelta('2 days 10 hours 45 min 20 s 35 ms 55 ns')

# Timedeltaを表示
print("Timedelta...\n", timedelta)

# freq='ms'を指定して
# ミリ秒解像度でフロア処理したTimedeltaを取得
res = timedelta.floor(freq='ms')

# 結果を表示
print("\nTimedelta (milliseconds floored)...\n", res)

出力結果

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

Timedelta...
2 days 10:45:20.035000055

Timedelta (milliseconds floored)...
2 days 10:45:20.035000

元のTimedeltaには55ナノ秒が含まれていましたが、floor(freq='ms')を適用することで、ナノ秒部分が切り下げられ、ミリ秒単位までの値になっていることが確認できます。