Python timedelta.total_secondsの使い方

Python
メソッド

最終更新日: 2025/11/28

この記事のポイント

Pythonで時間の差を秒数に変換する方法について、基本的な使い方から実際のプログラムでの応用まで詳しく説明していきます。

timedelta.total_secondsによる秒数変換機能
基本構文とコードの書き方パターン
実際の開発現場での活用事例とサンプルコード

これらのポイントを押さえることで、時間計算を含むプログラムを効率的に作成できるようになります。

timedelta.total_secondsとは？

timedelta.total_secondsは、datetimeモジュールのtimedeltaオブジェクトが持つメソッドの一つで、時間差を秒数で表現するために使用します。

timedeltaオブジェクトは日数、秒数、マイクロ秒といった複数の単位で時間の差を管理していますが、total_secondsメソッドを呼び出すことで、これらすべてを統一した秒数として取得できます。このメソッドは浮動小数点数を返すため、ミリ秒以下の精度も保持されます。プログラムで時間の計算や比較を行う際に非常に役立つ機能です。

【関連】
Pythonをもっと詳しく学ぶならpaizaラーニング

基本構文

timedelta.total_secondsは、timedeltaオブジェクトに対して呼び出すだけで使用できます。以下に基本的な使用パターンを示します。まず、datetimeモジュールをインポートし、timedeltaオブジェクトを作成してからtotal_secondsメソッドを実行します。

from datetime import timedelta # 基本的な使用例 td = timedelta(hours=1, minutes=30, seconds=45) total_sec = td.total_seconds() print(total_sec)

出力結果

5445.0

from datetime import timedelta # 日数を含む場合 td = timedelta(days=2, hours=5) total_sec = td.total_seconds() print(f"合計秒数: {total_sec}")

出力結果

合計秒数: 190800.0

実用例

timedelta.total_secondsの実際の使用場面では、処理時間の測定、期限管理、ログ解析など多岐にわたります。以下では具体的なコードサンプルを通じて、実際の開発現場でよく使われるパターンを紹介していきます。

各例では動物をテーマにしたデータを使用して、分かりやすく説明します。これらのサンプルコードを参考にすることで、自分のプロジェクトに応用できるでしょう。

動物の年齢計算と秒数変換

ペットの年齢を日数で管理し、それを秒数に変換して詳細な時間計算を行う例です。

from datetime import timedelta pet_age_days = 365 * 3 age_timedelta = timedelta(days=pet_age_days) age_seconds = age_timedelta.total_seconds() print(f"ネコの年齢: {age_seconds}秒")

出力結果

ネコの年齢: 94608000.0秒

動物園の営業時間計算

動物園の営業時間を計算し、一日の営業時間を秒数で管理するシステムの例です。

from datetime import timedelta opening_hours = timedelta(hours=9) closing_hours = timedelta(hours=17, minutes=30) business_duration = closing_hours - opening_hours business_seconds = business_duration.total_seconds() print(f"動物園営業時間: {business_seconds}秒")

出力結果

動物園営業時間: 30600.0秒

動物の睡眠時間分析

ライオンの一日の睡眠時間を分析し、秒単位での詳細データを取得する例です。

from datetime import timedelta lion_sleep = timedelta(hours=20, minutes=15) sleep_seconds = lion_sleep.total_seconds() awake_seconds = 86400 - sleep_seconds # 一日は86400秒 print(f"ライオンの起きている時間: {awake_seconds}秒")

出力結果

ライオンの起きている時間: 13500.0秒

動物の餌やり間隔管理

パンダの餌やり間隔を秒数で管理し、次回の餌やり時間を計算する例です。

from datetime import timedelta feeding_interval = timedelta(hours=4, minutes=30) interval_seconds = feeding_interval.total_seconds() daily_feedings = 86400 / interval_seconds print(f"パンダの一日の餌やり回数: {daily_feedings:.1f}回")

出力結果

パンダの一日の餌やり回数: 5.3回

渡り鳥の飛行時間計算

渡り鳥の連続飛行時間を秒数で計算し、休憩タイミングを管理する例です。

from datetime import timedelta flight_duration = timedelta(hours=12, minutes=45, seconds=30) flight_seconds = flight_duration.total_seconds() rest_needed = flight_seconds * 0.2 # 飛行時間の20%休憩 print(f"ツバメの必要休憩時間: {rest_needed}秒")

出力結果

ツバメの必要休憩時間: 9186.0秒

水族館の水槽清掃スケジュール

イルカの水槽清掃間隔を日数と時間で設定し、秒数での管理システムを作成する例です。

from datetime import timedelta cleaning_cycle = timedelta(days=3, hours=6) cycle_seconds = cleaning_cycle.total_seconds() monthly_cleanings = (30 * 86400) / cycle_seconds print(f"イルカ水槽の月間清掃回数: {monthly_cleanings:.1f}回")

出力結果

イルカ水槽の月間清掃回数: 9.2回

動物の医療検査間隔

ゾウの定期健康診断の間隔を管理し、次回検査までの残り時間を秒数で計算する例です。

from datetime import timedelta exam_interval = timedelta(weeks=8, days=2) interval_seconds = exam_interval.total_seconds() hours_between_exams = interval_seconds / 3600 print(f"ゾウの検査間隔: {hours_between_exams}時間")

出力結果