Django数据库日期查询异常及SQL函数报错求助

一、先确认时区与字段配置 #

• 检查settings.py：确保USE_TZ = True，同时数据库连接配置指定了正确时区（比如MySQL的TIME_ZONE = 'UTC'，PostgreSQL的TIMEZONE = 'UTC'）。时区不匹配会导致日期提取异常。
• 核实created_at字段定义：必须是models.DateTimeField(auto_now_add=True)，且数据库中该字段存储的是有效UTC datetime值（直接查数据库表确认，比如MySQL执行SELECT created_at FROM your_model_table LIMIT 5;）。

二、替换失效的strftime查询 #

strftime是SQLite专属函数，如果你用MySQL/PostgreSQL，必然报函数不存在。而且Django的extra方法已废弃，改用跨数据库兼容的数据库函数：

按日期分组统计的正确写法 #

from django.db.models.functions import TruncDate
from django.db.models import Count

# 提取日期并分组计数
result = YourModel.objects.annotate(
    record_date=TruncDate('created_at')
).values('record_date').annotate(total=Count('id')).order_by('record_date')

如果需要自定义日期格式（比如YYYY-MM-DD） #

建议拿到结果后在Python里格式化，更简洁：

# 先拿到日期对象，再转字符串
for item in result:
    item['formatted_date'] = item['record_date'].strftime('%Y-%m-%d')

如果一定要在数据库层面生成格式化字符串，用Django的Extract系列函数结合Concat（跨数据库兼容）：

from django.db.models import Value, CharField, F
from django.db.models.functions import Concat, ExtractYear, ExtractMonth, ExtractDay

result = YourModel.objects.annotate(
    year=ExtractYear('created_at'),
    month=ExtractMonth('created_at'),
    day=ExtractDay('created_at'),
    formatted_date=Concat(
        'year', Value('-'),
        # 月份补零：如果月份<10，拼接'0'，否则直接取月份
        F('month').case(
            when=[(F('month') < 10, Concat(Value('0'), 'month'))],
            default=F('month'),
            output_field=CharField()
        ),
        Value('-'),
        # 日期补零同理
        F('day').case(
            when=[(F('day') < 10, Concat(Value('0'), 'day'))],
            default=F('day'),
            output_field=CharField()
        )
    )
).values('formatted_date').annotate(total=Count('id'))

三、解决created_at__date返回None的问题 #

• 直接用TruncDate替代values('created_at__date')，后者依赖数据库的日期提取逻辑，一旦时区或字段有问题就会返回None。
• 手动在数据库执行日期提取查询，验证是否能得到结果：
  • MySQL：SELECT DATE(created_at) FROM your_model_table;
  • PostgreSQL：SELECT DATE(created_at) FROM your_model_table;
  • SQLite：SELECT strftime('%Y-%m-%d', created_at) FROM your_model_table;
    如果数据库查询也返回NULL，说明字段存储的datetime值无效（比如是0000-00-00 00:00:00这类非法值），需要修复数据。
• 检查是否有自定义模型管理器或QuerySet修改了created_at的返回值，导致日期提取失效。

四、验证数据库函数可用性 #

执行对应数据库的日期函数测试语句，确认函数正常：

• MySQL：SELECT DATE(NOW());
• PostgreSQL：SELECT CURRENT_DATE;
• SQLite：SELECT strftime('%Y-%m-%d', DATETIME('now'));
  如果数据库层面函数返回异常，需要排查数据库的时区配置或修复数据库环境。

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