Django Rest Framework序列化器保留时区并去除毫秒问题

我之前也踩过DRF日期格式化的坑——手动指定格式时很容易不小心把时区转成UTC，咱们一步步来搞定：

首先得搞明白你之前的问题根源：当给DateTimeField指定format参数但没设置localize=True时，DRF会默认把时区感知的datetime转成UTC再格式化，这就是时区变了的原因。

方案一：用内置参数快速解决 #

如果你的项目已经在settings.py里把TIME_ZONE设为东部时区（比如America/New_York），并且USE_TZ = True，那直接在序列化器里这么写就行：

from rest_framework import serializers

class YourSerializer(serializers.ModelSerializer):
    create_dt = serializers.DateTimeField(
        format="%Y-%m-%dT%H:%M:%S%z",
        localize=True  # 关键！告诉DRF用项目设置的本地时区（东部时区）格式化
    )

    class Meta:
        model = YourModel
        fields = ['create_dt', ...]

这样输出的格式会是"2016-01-04T09:06:17-0500"，既去掉了毫秒，又保留了东部时区的偏移。

方案二：自定义字段（适合特殊场景） #

如果需要强制固定用东部时区，不受项目全局设置影响，可以自定义一个专属字段：

from rest_framework import serializers
from django.utils import timezone

class EasternDateTimeField(serializers.DateTimeField):
    def to_representation(self, value):
        # 强制转换为东部时区
        eastern_tz = timezone.get_timezone('America/New_York')
        localized_dt = timezone.localtime(value, eastern_tz)
        # 格式化时剔除毫秒，保留时区标识
        return localized_dt.strftime("%Y-%m-%dT%H:%M:%S%z")

# 在序列化器中使用这个自定义字段
class YourSerializer(serializers.ModelSerializer):
    create_dt = EasternDateTimeField()

    class Meta:
        model = YourModel
        fields = ['create_dt', ...]

这种方法适合跨时区的多模块项目，确保这个字段的输出始终符合东部时区要求。

额外技巧：全局统一配置 #

如果整个API的日期都需要这种格式，不用每个序列化器重复写，可以在settings.py里配置DRF全局规则：

REST_FRAMEWORK = {
    'DATETIME_FORMAT': "%Y-%m-%dT%H:%M:%S%z",
}

同时确保USE_TZ=True和TIME_ZONE设置正确，之后每个DateTimeField只需加上localize=True，就能自动套用东部时区+无毫秒的格式。

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