Python Pandas入門：ceil()メソッドで秒単位の解像度に切り上げた新しいTimedeltaを取得する方法

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

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

まず、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を表示して確認します。

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

秒単位の解像度で切り上げる

freq='S'を指定してceil()メソッドを呼び出すと、秒単位の解像度に切り上げられた結果が得られます。元の値が「20秒35ミリ秒55ナノ秒」であるため、切り上げ後は「21秒」になります。

timedelta.ceil(freq='S')

サンプルコード全体

以下に、ここまでの手順をまとめた完全なコードを示します。

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)

# 秒単位の解像度で切り上げた結果を取得
res = timedelta.ceil(freq='S')

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

実行結果

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

Timedelta...
2 days 10:45:20.035000055

Timedelta (seconds ceiled)...
2 days 10:45:21

このように、ceil()メソッドとfreqパラメータを組み合わせることで、任意の単位（秒・分・時間など）でTimedeltaを簡単に切り上げることができます。同様に、floor()メソッドを使えば切り捨て、round()メソッドを使えば四捨五入も可能です。