Python Pandas – Timedeltaからnamedtuple形式のコンポーネントを取得する方法

PandasのTimedeltaオブジェクトから、namedtuple（名前付きタプル）形式で時間の構成要素を取得するには、timedelta.components属性を使用します。この属性を使うことで、日数・時間・分・秒・ミリ秒・マイクロ秒・ナノ秒といった各単位に分解された値を、属性アクセス可能な形で簡単に取り出せます。

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

import pandas as pd

Timedeltaオブジェクトの作成

TimeDeltaは、Python標準のdatetimeライブラリが持つtimedeltaとは異なる独自の表現形式を採用しており、より高精度な時間差の計算が可能です。ここでは、文字列からTimedeltaオブジェクトを作成します。

timedelta = pd.Timedelta('1 days 10 min 20 s')

コンポーネントの取得

作成したTimedeltaオブジェクトに対して.componentsを呼び出すと、namedtuple形式の構成要素が返されます。

timedelta.components

完全なコード例

以下に、一連の処理をまとめたサンプルコードを示します。

import pandas as pd

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

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

# namedtuple形式のコンポーネントを取得
res = timedelta.components

# 各構成要素を表示
print("\nComponent...\n", res)

実行結果

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

Timedelta...
 1 days 00:10:20

Component...
 Components(days=1, hours=0, minutes=10, seconds=20, milliseconds=0, microseconds=0, nanoseconds=0)

このように、Components(days=..., hours=..., ...)というnamedtupleとして各要素が返されるため、res.daysやres.minutesのように属性名を指定して、特定の単位の値だけを直接参照することもできます。