Python Pandas – Timedeltaをミリ秒の解像度で切り上げて返す方法

Pandasのtimedelta.ceil()メソッドを使うと、指定した解像度に切り上げた新しいTimedeltaオブジェクトを取得できます。ミリ秒単位で切り上げたい場合は、freqパラメータに「ms」を指定します。

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

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

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)

ミリ秒の解像度で切り上げる

freq='ms'を指定して、ミリ秒の解像度で切り上げたTimedeltaを返します。元の値が「35ms 55ns」であるため、55ナノ秒が切り上げられ、36ミリ秒になります。

timedelta.ceil(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)

# ミリ秒の解像度で切り上げたTimedeltaを取得
res = timedelta.ceil(freq='ms')

# 切り上げ後のTimedeltaを表示
print("\nTimedelta (milliseconds ceiled)...\n", res)

出力結果

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

Timedelta...
2 days 10:45:20.035000055

Timedelta (milliseconds ceiled)...
2 days 10:45:20.036000

このように、ceil()メソッドにfreq='ms'を渡すことで、ナノ秒以下の端数がミリ秒単位に切り上げられた新しいTimedeltaを簡単に取得できます。同様の操作として、切り捨てにはfloor()、四捨五入にはround()メソッドも用意されています。