为何Django ORM naive datetime查询与PostgreSQL时区感知查询结果一致？

问题场景 #

我在Django中使用naive datetime字符串筛选指定日期范围的预约数据，对应的ORM查询如下：

start_d_date_naive = "2024-11-3 00:00"
end_d_date_naive = "2024-11-3 23:59"
reserve_naive = Reservations.objects.filter(
    updated_at__range=(start_d_date_naive, end_d_date_naive), status="canceled"
)

该ORM查询转换为SQL语句：

SELECT * FROM "consultant_reservations"
WHERE "consultant_reservations"."status" = 'canceled'
AND "consultant_reservations"."updated_at" BETWEEN '2024-11-03 00:00:00' AND '2024-11-03 23:59:00'

但执行结果却与直接在PostgreSQL中运行的带时区感知的查询结果完全相同：

SELECT * FROM "consultant_reservations"
WHERE updated_at BETWEEN '2024-11-03 00:00:00+03:30' AND '2024-11-03 23:59:00+03:30'
AND status='canceled';

环境配置信息 #

• Django settings.py配置：

  TIME_ZONE = 'Asia/Tehran'
  USE_TZ = False
  

• Django Shell验证：

  In [14]: from django.conf import settings
  In [15]: print(settings.TIME_ZONE)
  Asia/Tehran
  

• PostgreSQL服务器时区：

  => SHOW timezone;
   TimeZone 
  ----------
   Etc/UTC
  (1 row)
  

• Ubuntu服务器时区：

  $ timedatectl
                 Local time: Tue 2024-11-05 12:25:58 UTC
             Universal time: Tue 2024-11-05 12:25:58 UTC
                   RTC time: Tue 2024-11-05 12:25:58
                  Time zone: Etc/UTC (UTC, +0000)
  System clock synchronized: yes
                NTP service: active
            RTC in local TZ: no
  

原因解析 #

出现这种结果的核心逻辑是Django与PostgreSQL的会话时区匹配，结合USE_TZ=False的时间处理规则：

1. Django强制设置数据库会话时区
   无论USE_TZ开关状态如何，Django连接PostgreSQL时都会自动将数据库会话的时区设置为settings.TIME_ZONE（即Asia/Tehran）。你通过psql查询到的Etc/UTC是客户端独立会话的时区，和Django使用的数据库会话无关。

2. USE_TZ=False下的时间存储与查询
   当USE_TZ=False时，Django不会做任何时区转换，直接将Asia/Tehran时区的naive datetime写入数据库的timestamp without time zone字段。执行ORM查询时，传入的naive datetime字符串会被PostgreSQL当作Asia/Tehran时区的本地时间，筛选11月3日全天的数据。

3. 带时区查询的实际等效性
   你执行的带+03:30时区的PostgreSQL查询，若该查询是在Django创建的会话中运行（比如通过Django Shell的数据库游标），此时会话时区为Asia/Tehran：

   • PostgreSQL会将带时区的时间字符串转换为当前会话时区的naive datetime，'2024-11-03 00:00:00+03:30'恰好对应Asia/Tehran时区的2024-11-03 00:00:00。
   • 最终这个查询的筛选范围和Django ORM生成的查询完全一致，因此返回结果相同。

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