Django：如何使用IntegerField的F表达式注解DateField

你的核心问题是Python内置的date()函数无法与Django的F表达式配合使用——date()在查询构造阶段就会执行，而F表达式是延迟到数据库层面解析的，两者不能直接混合。正确的做法是用Django提供的数据库函数在数据库端构造日期。

解决方案：使用DateFromParts数据库函数 #

Django的DateFromParts函数可以直接在SQL层面通过年、月、日的数值构造日期，完美支持用F表达式引用模型字段作为日参数。

步骤1：导入需要的模块

from datetime import date
from django.db.models import F
from django.db.models.functions import DateFromParts

步骤2：构造查询并过滤

用DateFromParts替代Python的date()函数，直接传入年份、月份和F('day_due')：

# 查询所有到期日为1日及更早的RentDue
RentDue.objects.annotate(
    rent_due_date=DateFromParts(2022, 12, F('day_due'))
).filter(
    rent_due_date__lte=date(2022, 12, 1)
)
# 返回 [rent_due_first]

# 查询所有到期日为3日及更早的RentDue
RentDue.objects.annotate(
    rent_due_date=DateFromParts(2022, 12, F('day_due'))
).filter(
    rent_due_date__lte=date(2022, 12, 3)
)
# 返回 [rent_due_first, rent_due_third]

动态计算下一个月的到期日（可选） #

如果不需要固定年份月份，而是要动态计算下一个月的到期日，可以结合TruncMonth和AddMonths函数自动获取下一个月的年、月：

from django.db.models.functions import TruncMonth, AddMonths, ExtractYear, ExtractMonth
from django.db.models import Value

# 动态生成下一个月的到期日
RentDue.objects.annotate(
    # 获取当前日期所在月份的第一天
    current_month_start=TruncMonth(Value(date.today())),
    # 计算下一个月的第一天
    next_month_start=AddMonths(F('current_month_start'), 1),
    # 提取下一个月的年和月
    next_year=ExtractYear(F('next_month_start')),
    next_month_num=ExtractMonth(F('next_month_start')),
    # 构造到期日
    rent_due_date=DateFromParts(F('next_year'), F('next_month_num'), F('day_due'))
).filter(
    # 过滤下一个月3日及之前到期的记录
    rent_due_date__lte=date(date.today().year + (1 if date.today().month == 12 else 0), 
                            date.today().month % 12 + 1, 3)
)

为什么之前的方法出错？ #

Python的date()是本地执行的函数，在你写代码的时候就会尝试计算参数值，但F('day_due')只是一个数据库字段的引用标记，不是实际整数，所以会抛出TypeError: an integer is required (got type F)。而DateFromParts是Django的数据库函数，会把整个构造逻辑转换成SQL语句，在数据库端完成日期计算，自然支持字段引用。

内容的提问来源于stack exchange，提问作者Sean D.