如何覆盖Django DateField查询逻辑，自动转换为周起始日期进行搜索

不需要子类化DateField，有两种更符合Django设计规范的实现方式：

方案1：自定义管理器新增专属查询方法（最推荐） #

这种方式逻辑最清晰，不会破坏Django默认查询行为，避免出现非预期的查询结果，同时可以把周起始日的计算逻辑抽成公共方法复用，避免save和查询逻辑重复。

import datetime
from django.db import models

# 公共周起始日计算方法，save和查询逻辑共用
def get_week_start(date_val):
    return date_val - datetime.timedelta(days=date_val.weekday())

class WeekManager(models.Manager):
    # 自定义按任意日期查询周的方法
    def get_by_any_date(self, date_val):
        week_start = get_week_start(date_val)
        return self.filter(start_date=week_start)

class Week(models.Model):
    start_date = models.DateField()
    # 替换默认管理器
    objects = WeekManager()
    
    def save(self, *args, **kwargs):
        self.start_date = get_week_start(self.start_date)
        # 原示例漏了调用父类save方法，加上才会实际写入数据库
        super().save(*args, **kwargs)

使用时直接调用自定义方法即可：

# 传入任意日期都能返回对应周的对象
this_week = Week.objects.get_by_any_date(date.today())

方案2：重写管理器的filter方法（适配原有查询写法） #

如果你希望保持Week.objects.filter(start_date=xxx)的原有写法也能自动转换日期，可以重写管理器的filter方法，自动处理传入的start_date参数：

class WeekManager(models.Manager):
    def filter(self, *args, **kwargs):
        # 仅处理直接查询start_date等于某个日期的场景
        if "start_date" in kwargs:
            input_val = kwargs["start_date"]
            # 跳过带查询后缀的条件、非日期类型的参数
            if isinstance(input_val, datetime.date):
                kwargs["start_date"] = get_week_start(input_val)
        return super().filter(*args, **kwargs)

如果需要适配start_date__gte、start_date__range等带后缀的查询，你可以自行扩展解析key的逻辑，处理对应场景的日期转换即可。

为什么不推荐子类化DateField #

字段子类化适合处理数据存储、序列化层面的通用逻辑，你的需求属于业务查询层的定制，放在管理器里维护更符合Django的分层设计，后续调整规则、排查问题都更方便。

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