Django Admin中DateTime字段显示不一致问题求助

我创建了ActivityObject模型用于存储API返回的JSON数据，API提供UTC时间start_date和本地时间start_date_local，但目前这两个时间字段被不一致处理，出现值颠倒的异常。

模型代码 #

class ActivityObject(models.Model):
    name = models.CharField(max_length=50)
    distance = models.DecimalField(max_digits=8, decimal_places=2)
    moving_time = models.DurationField()
    elapsed_time = models.DurationField()
    total_elevation_gain = models.DecimalField(max_digits=5, decimal_places=2)
    type = models.CharField(max_length=15)
    start_date = models.DateTimeField()
    start_date_local = models.DateTimeField()
    average_speed = models.DecimalField(max_digits=5, decimal_places=2, blank=True, null=True)
    max_speed = models.DecimalField(max_digits=5, decimal_places=2, blank=True, null=True)
    average_cadence = models.DecimalField(max_digits=6, decimal_places=2, blank=True, null=True)
    has_heartrate = models.BooleanField(blank=True, null=True)
    average_heartrate = models.DecimalField(max_digits=6, decimal_places=2, blank=True, null=True)
    max_heartrate = models.DecimalField(max_digits=6, decimal_places=2, blank=True, null=True)

    activity_logged_time = models.DateTimeField(default=timezone.now, blank=True)

    def __str__(self):
        return 'id %s----name %s----start date %s----start date local %s----logged date %s' % (self.id, self.name,
                                                                                               self.start_date,
                                                                                               self.start_date_local,
                                                                                               self.activity_logged_time)

异常表现 #

• Admin列表视图：start_date显示为本地时间（2022-11-05 08:01:20），start_date_local显示为UTC时间（2022-11-04 21:01:20），二者值完全颠倒
• Admin详情视图：两个字段的显示同样存在值颠倒的问题

数据转换代码 #

start_date = a_row['start_date']
start_date_pretty = convert_json_to_datetime(start_date)
print('start date ', start_date_pretty)

start_date_local = a_row['start_date_local']
start_date_local_pretty = convert_json_to_datetime(start_date_local)
print('start date local ', start_date_local_pretty)

API返回的JSON键值对 #

"start_date": "2022-11-04T21:01:20Z", "start_date_local": "2022-11-05T08:01:20Z"

项目时区设置 #

USE_TZ = True

解决方案 #

原因分析 #

当USE_TZ = True时，Django的DateTimeField会默认将存储的时间视为UTC时间，展示时自动转换为项目TIME_ZONE配置的本地时区。但start_date_local本身是本地时间，无时区标识，Django会误将其当作UTC时间再做一次时区转换，最终导致两个字段的显示值颠倒。

具体修复步骤 #

1. 修正时间转换逻辑
   针对两种时间格式分别处理，确保生成带正确时区信息的datetime对象：

   from django.utils import timezone
   from datetime import datetime
   
   def convert_json_to_datetime(date_str):
       if date_str.endswith('Z'):
           # 处理UTC时间，标记为UTC时区的aware对象
           dt = datetime.strptime(date_str, "%Y-%m-%dT%H:%M:%SZ")
           return timezone.make_aware(dt, timezone.utc)
       else:
           # 处理本地时间，标记为项目TIME_ZONE对应的时区对象
           dt = datetime.strptime(date_str, "%Y-%m-%dT%H:%M:%SZ")
           return timezone.make_aware(dt)
   

2. 验证存储与展示
   确保start_date存储的是UTC时区的aware datetime，start_date_local存储的是本地时区的aware datetime，Django会自动在Admin中展示为正确的本地时间（或根据时区配置对应转换）。

3. Admin自定义显示（可选）
   如果需要在Admin中明确区分时区，可自定义字段显示格式：

   from django.contrib import admin
   from .models import ActivityObject
   
   class ActivityObjectAdmin(admin.ModelAdmin):
       list_display = ('name', 'start_date_utc', 'start_date_local_display')
   
       def start_date_utc(self, obj):
           return obj.start_date.strftime("%Y-%m-%d %H:%M:%S UTC")
       start_date_utc.short_description = '开始时间（UTC）'
   
       def start_date_local_display(self, obj):
           return obj.start_date_local.strftime("%Y-%m-%d %H:%M:%S 本地时间")
       start_date_local_display.short_description = '开始时间（本地）'
   
   admin.site.register(ActivityObject, ActivityObjectAdmin)
   

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