Python Pandas – Timedeltaオブジェクトから秒の値を取得する方法

Timedeltaオブジェクトから秒の値を取得するには、timedelta.seconds プロパティを使用します。この記事では、実際のコード例とともに、その使い方を詳しく解説します。

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

まず、pandasライブラリをインポートします。

import pandas as pd

Timedeltaオブジェクトとは

TimeDeltasは、Pythonの標準datetimeライブラリにおける時間差（timedelta）を表すデータ型です。Pandasでは pd.Timedelta() を使って簡単に作成できます。

ここでは、「10秒・15ミリ秒・33ナノ秒」のTimedeltaオブジェクトを作成してみましょう。

timedelta = pd.Timedelta('10 s 15 ms 33 ns')

Timedeltaオブジェクトの作成と表示

作成したTimedeltaオブジェクトを表示して確認します。

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

秒の値を取得する

seconds プロパティにアクセスすることで、Timedeltaオブジェクトから秒の値を取得できます。

timedelta.seconds

完全なコード例

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

import pandas as pd

# TimeDeltasはPythonの標準datetimeライブラリにおける時間差の表現
# Timedeltaオブジェクトを作成
timedelta = pd.Timedelta('10 s 15 ms 33 ns')

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

# 秒の値を取得
res = timedelta.seconds

# 結果を表示
print("\nTimedelta (seconds value)...\n", res)

実行結果

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

Timedelta...
0 days 00:00:10.015000033

Timedelta (seconds value)...
10

補足：seconds属性の注意点

timedelta.seconds は「0〜86399」の範囲の整数を返すことに注意してください。つまり、日数やミリ秒・ナノ秒の部分は含まれず、時間差の中の「秒」の成分のみが返されます。上の例では「10秒15ミリ秒33ナノ秒」という時間差に対し、秒の成分である 10 が返されています。

日数部分が必要な場合は timedelta.days、ナノ秒部分が必要な場合は timedelta.nanoseconds を使用するとよいでしょう。