Django查询集提取日期年份：筛选当年采购记录代码异常排查

嘿，我来帮你排查下代码里的问题，然后给出能正常运行的实现方案：

问题出在哪？ #

你的思路完全没问题——用date__year提取datetime字段的年份来筛选是Django ORM的正确用法，但可能有几个小细节没注意到导致代码跑不起来：

• 有没有忘记导入Purchases模型？这是新手常犯的错误
• 如果你的项目开启了时区支持，直接用datetime.date.today()可能会因为时区差异导致筛选出错

修正后的可运行代码 #

import datetime
from django.utils import timezone
from .models import Purchases  # 别忘了导入你的模型！

# 优先用时区兼容的方式获取当前年份
if settings.USE_TZ:
    current_year = timezone.now().year
else:
    current_year = datetime.date.today().year

# 筛选当年的采购记录
year_purchases = Purchases.objects.filter(date__year=current_year)

为什么要这么改？ #

• 模型导入：必须确保Purchases模型被正确导入，否则Django根本找不到这个表
• 时区处理：如果你的settings.USE_TZ = True（现在Django新项目默认开启），数据库存储的是UTC时间，而datetime.date.today()取的是本地时间，跨年时会出现筛选偏差，用timezone.now()能保证和数据库时区一致
• 变量名优化：把year改成year_purchases，更清晰，避免和年份数值混淆

验证方法 #

你可以通过以下方式确认筛选是否正确：

• 打印current_year，看是不是你预期的年份
• 执行print(year_purchases.query)查看生成的SQL语句，正常情况下会生成类似这样的SQL：

  SELECT "purchases"."id", "purchases"."date", ... FROM "purchases" WHERE EXTRACT(YEAR FROM "purchases"."date") = 2024
  

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