如何消除Django Query Annotation中AGE()函数的时区指定？

你遇到的问题是因为Django在USE_TZ = True的配置下，会自动对datetime字段添加时区转换处理，这就导致AGE()函数后面多了个AT TIME ZONE 'America/Los_Angeles'，进而触发Postgres的函数匹配错误。下面给你两种可行的修改方案：

方案一：使用RawSQL精确控制SQL片段 #

这是最直接稳妥的办法，直接把需要的EXTRACT('epoch' FROM AGE(created))用RawSQL插入，绕开Django的自动时区处理：

from django.db.models import F, RawSQL

all_proposals = Proposal.objects.annotate(
    display_rank=F('vote_score') / RawSQL("EXTRACT('epoch' FROM AGE(created))", [])
)

这样生成的SQL就会和你最初的原生查询完全一致，不会有多余的时区转换语句，Postgres也能正确解析AGE()和EXTRACT()的组合。

方案二：自定义Func类（进阶用法） #

如果你不想用原生SQL片段，可以自定义一个AGE函数类，强制Django不添加时区转换：

from django.db.models import Func, F, Extract
from django.db import models

class RawAGE(Func):
    function = 'AGE'
    output_field = models.DurationField()

    def as_sql(self, compiler, connection):
        # 重写as_sql方法，跳过Django的时区转换处理
        sql, params = super().as_sql(compiler, connection)
        # 移除自动添加的AT TIME ZONE部分
        sql = sql.replace(" AT TIME ZONE %s", "")
        params = params[:-1]
        return sql, params

all_proposals = Proposal.objects.annotate(
    display_rank=F('vote_score') / Extract(RawAGE(F('created')), 'epoch')
)

不过这个方法需要处理Django的SQL生成逻辑，相对复杂一些，推荐优先用方案一。

问题根源说明 #

当USE_TZ = True时，Django会将你的created字段视为带时区的datetime类型，在生成SQL时自动添加AT TIME ZONE转换到当前配置的时区。但Postgres的AGE()函数接受的是不带额外时区转换的datetime参数，这个多余的转换导致函数签名不匹配，所以触发了报错提示。

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