Django REST Framework贾拉利日期兼容性问题：DRF用公历验证致请求失败

这个问题的核心原因很明确：DRF默认的日期/时间字段是用Python标准库的datetime来解析和验证输入的，而像1397-02-31这类合法的贾拉利日期在公历体系里是无效的，所以DRF会直接抛出验证错误返回400。

要解决这个问题，我们需要自定义DRF的序列化字段，用django-jalali的jdatetime来处理贾拉利日期的解析、验证和格式转换，具体步骤如下：

1. 自定义DRF贾拉利日期/时间字段 #

创建一个fields.py文件，编写自定义字段，替换DRF默认的日期处理逻辑：

from rest_framework import serializers
from django_jalali.db.models import jdatetime
from datetime import datetime

class JalaliDateField(serializers.DateField):
    def to_internal_value(self, value):
        try:
            # 将贾拉利日期字符串解析为jdatetime.date，再转换为公历date对象存入数据库
            jalali_date = jdatetime.date.fromisoformat(value)
            return jalali_date.togregorian()
        except ValueError as e:
            raise serializers.ValidationError(f"无效的贾拉利日期: {str(e)}")

class JalaliDateTimeField(serializers.DateTimeField):
    def to_internal_value(self, value):
        try:
            # 解析贾拉利日期时间字符串为jdatetime.datetime，转成公历datetime存入数据库
            jalali_dt = jdatetime.datetime.fromisoformat(value)
            return jalali_dt.togregorian()
        except ValueError as e:
            raise serializers.ValidationError(f"无效的贾拉利日期时间: {str(e)}")

    def to_representation(self, value):
        # 读取数据库的公历datetime，转换为贾拉利格式字符串返回给前端
        if not value:
            return None
        jalali_dt = jdatetime.datetime.fromgregorian(datetime=value)
        return jalali_dt.isoformat()

2. 在序列化器中使用自定义字段 #

在你的ModelSerializer里，把原来的DateField或DateTimeField替换成我们自定义的字段：

from rest_framework import serializers
from .models import YourModel
from .fields import JalaliDateTimeField

class YourModelSerializer(serializers.ModelSerializer):
    # 替换默认的DateTimeField为自定义的贾拉利日期时间字段
    schedule_time = JalaliDateTimeField()

    class Meta:
        model = YourModel
        fields = ['id', 'schedule_time', '其他字段']

3. 验证效果 #

现在你再提交如1397-02-31这类合法的贾拉利日期，DRF会先用jdatetime验证其有效性（确保是合法的贾拉利日期），然后自动转换为对应的公历日期存入数据库；当返回响应时，又会把数据库里的公历日期转回贾拉利格式返回给前端，完全适配你的业务需求。

另外要确认你的模型字段已经使用了django-jalali提供的JDateField或JDateTimeField（比如from django_jalali.db import models里的字段），这一步你应该已经完成了，因为admin和shell能正常工作。

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