Python Pandas – 指定した解像度に切り上げた新しいTimedeltaを返す方法

指定した解像度（頻度）に切り上げた新しい Timedelta を返すには、timedelta.ceil() メソッドを使用します。切り上げの単位は、freq パラメータで指定します。

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

import pandas as pd

TimeDeltas は、Python の標準 datetime ライブラリで使用される timedelta とは異なる表現形式を持っています。ここでは、pd.Timedelta を使って Timedelta オブジェクトを作成します。

timedelta = pd.Timedelta('6 days 1 min 30 s')

作成した Timedelta オブジェクトを表示してみましょう。

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

次に、ceil() メソッドを使い、freq='D'（日単位）を指定して切り上げを行います。これにより、6日と1分30秒の値が、直近の「日」の区切りである7日へと切り上げられます。

res = timedelta.ceil(freq='D')

サンプルコード

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

import pandas as pd

# TimeDeltas は Python の標準 datetime ライブラリの timedelta とは異なる表現形式を持つ
# Timedelta オブジェクトを作成
timedelta = pd.Timedelta('6 days 1 min 30 s')

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

# freq='D'（日単位）を指定して切り上げた結果を取得
res = timedelta.ceil(freq='D')

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

実行結果

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

Timedelta...
6 days 00:01:30

Timedelta (ceiled)...
7 days 00:00:00

このように、ceil() メソッドに freq パラメータを渡すことで、任意の解像度（日・時間・分など）に基づいて Timedelta の値を切り上げることができます。なお、逆に切り下げたい場合は floor() メソッド、四捨五入したい場合は round() メソッドを使用します。