如何在Django中获取DurationField字段的秒数数值

Django的DurationField从数据库取出后，实际返回的是Python的timedelta对象，打印时显示为HH:MM:SS格式，可通过以下几种方式转换为秒数：

1. 遍历对象时直接转换 #

利用timedelta自带的total_seconds()方法直接计算总秒数：

steps = Step.objects.all()
for s in steps:
    # 返回浮点数（包含微秒部分，例如0:00:05会返回5.0）
    print(s.duration.total_seconds())
    # 如需整数秒，转换为int即可
    print(int(s.duration.total_seconds()))

2. 在模型中添加属性（推荐复用） #

给Step模型增加一个属性，方便代码中直接调用：

from django.db import models
from datetime import timedelta

class Step(models.Model):
    stepnumber = models.CharField(max_length=500)
    description = models.TextField()
    duration = models.DurationField(default=timedelta)

    @property
    def duration_seconds(self):
        # 返回整数格式的总秒数
        return int(self.duration.total_seconds())

使用时直接访问该属性：

for s in steps:
    print(s.duration_seconds)

3. 数据库层面批量计算 #

如果需要批量查询时直接获取秒数，可使用Django数据库函数让数据库完成计算，减少Python端处理：

from django.db.models import ExpressionWrapper, IntegerField
from django.db.models.functions import ExtractHour, ExtractMinute, ExtractSecond

# 注解出秒数字段
steps = Step.objects.annotate(
    duration_seconds=ExpressionWrapper(
        ExtractHour('duration') * 3600 + ExtractMinute('duration') * 60 + ExtractSecond('duration'),
        output_field=IntegerField()
    )
)

# 直接获取计算好的秒数
for s in steps:
    print(s.duration_seconds)

补充说明：MySQL中DurationField以微秒存储，但Django会自动封装为timedelta对象，直接使用timedelta的方法是最直接的处理方式。

内容的提问来源于stack exchange，提问作者Sajwal Tamrakar