Python Pandas – TimedeltaをISO 8601形式にフォーマットする方法

PandasのTimedelta（時間差）オブジェクトをISO 8601形式にフォーマットするには、timedelta.isoformat()メソッドを使用します。この記事では、実際のコード例とともにその手順をわかりやすく解説します。

手順1：ライブラリのインポート

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

import pandas as pd

手順2：Timedeltaオブジェクトの作成

次に、Timedeltaオブジェクトを作成します。

timedelta = pd.Timedelta('4 days 11 hours 38 min 20 s 35 ms 55 ns')

手順3：Timedeltaの表示

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

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

手順4：ISO 8601形式へのフォーマット

isoformat()メソッドを呼び出すことで、TimedeltaをISO 8601形式に変換できます。

timedelta.isoformat()

完全なコード例

以下は、ここまでの手順をまとめた完全なサンプルコードです。

import pandas as pd

# TimeDeltasはPythonの標準datetimeライブラリとは異なる表現を使用します

# Timedeltaオブジェクトを作成
timedelta = pd.Timedelta('4 days 11 hours 38 min 20 s 35 ms 55 ns')

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

# ISO 8601形式にフォーマット
res = timedelta.isoformat()

# ISO 8601形式に変換した結果を表示
print("\nFormat Timedelta as ISO 8601...\n", res)

実行結果

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

Timedelta...
4 days 11:38:20.035000055

Format Timedelta as ISO 8601...
P4DT11H38M20.035000055S

出力結果の読み方

ISO 8601の期間（duration）表記では、各記号が以下の意味を持ちます。

• P：期間（Period）であることを示す接頭辞
• 4D：4日間
• T：日付部分と時刻部分の区切り
• 11H：11時間
• 38M：38分
• 20.035000055S：20.035000055秒

つまり「P4DT11H38M20.035000055S」は、「4日と11時間38分20.035000055秒」の期間をISO 8601規格に従って表現したものです。ナノ秒単位の精度まで正確に保持されるため、時刻データの厳密な交換や保存が必要な場面で非常に便利です。