Mongoose查询时如何保留datetime类型的数据库原始存储值

问题现象 #

• 数据库内存储的DateTime原始值如下：
  
• 执行query查询时，框架/驱动会自动结合当前时区完成值转换，再映射到model中，得到转换后的值：
  
• 目标：查询后直接返回数据库存储的DateTime原始值，不触发任何自动时区转换逻辑。

实现方案 #

驱动层全局关闭（推荐，适配所有ORM框架） #

直接在数据库连接串中配置，从最底层拦截时区自动转换逻辑，一次配置全局生效：

• MySQL 连接串追加参数：serverTimezone=UTC&useTimezone=false（将UTC替换为你数据库实际存储值使用的时区即可）
• PostgreSQL 连接串追加参数：options=-c timezone=UTC
• JDBC系驱动可追加参数：useLegacyDatetimeCode=false&serverTimezone=和数据库存储时区一致

分框架配置 #

Django ORM

1. 全局关闭时区自动转换，修改settings.py配置：

USE_TZ = False

2. 若需保留全局时区配置，仅单字段取原始值，查询时用原生SQL函数绕过ORM转换：

from django.db.models.functions import RawSQL
result = MyModel.objects.annotate(raw_create_time=RawSQL("create_time", []))

SQLAlchemy

1. 创建引擎时指定和数据库存储一致的时区，关闭自动偏移计算：

from sqlalchemy import create_engine
engine = create_engine("你的数据库连接串", connect_args={"timezone": "数据库存储使用的时区"})

2. 字段映射时指定DateTime类型不带时区属性：Column(DateTime(timezone=False))

MyBatis/MyBatis-Plus

1. 连接串配置和数据库存储一致的时区，关闭驱动自动转换
2. 实体类对应字段使用LocalDateTime类型接收，不要使用ZonedDateTime/OffsetDateTime这类带时区属性的类型，避免触发转换。

Entity Framework Core

1. 数据库上下文配置中关闭时区转换：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseMySql("连接串", ServerVersion.AutoDetect("连接串"), 
        b => b.EnableTimeZoneConversion(false));
}

2. 字段使用无Kind标记的DateTime类型接收，避免框架自动根据本地时区做偏移。

补充说明：如果数据库字段类型为timestamp（部分数据库的timestamp类型会自动做时区转换存储），上述配置无法拿到原始值，需要将字段类型修改为datetime/datetime2这类无时区自动处理逻辑的类型。

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