Sequelize搭配sqlite3插入DATE类型默认+0:00时区如何适配本地时区

• 运行环境：Node v16及以上版本
• 技术栈：Sequelize ORM 搭配 sqlite3 方言
• 异常表现：调用model.create()写入DATE类型字段时，无论传入new Date()实例，还是给列设置默认值为(DATETIME('NOW', 'LOCALTIME'))，Sequelize都会默认追加+00:00的UTC时区偏移，无法自主控制时区配置，时间读写也无法遵循本地机器的时区设置。

方案1：初始化Sequelize时配置时区参数（优先推荐） #

初始化Sequelize实例时添加两个关键配置，从全局层面关闭默认的UTC强制转换逻辑，自动适配本地机器时区：

const { Sequelize } = require('sequelize')

const sequelize = new Sequelize({
  dialect: 'sqlite',
  storage: '你的sqlite数据库文件路径',
  // 自动读取当前运行环境的本地时区
  timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
  dialectOptions: {
    // 关闭sqlite驱动默认的UTC时间转换
    useUTC: false
  }
})

配置生效后，Sequelize拼接写入SQL、解析查询返回结果时，都不会强制将时间转为UTC时区，会自动对齐本地机器时区，不会再默认追加+00:00偏移。

方案2：模型字段层面自定义序列化逻辑（适配低版本Sequelize） #

Sequelize 6.20以下版本对sqlite方言的timezone配置存在已知bug，全局配置不生效时，可以直接在模型定义时给DATE字段加自定义读写逻辑，绕开默认的时区转换：

const { DataTypes, Sequelize } = require('sequelize')

const BizModel = sequelize.define('biz_table', {
  // 其余业务字段...
  createTime: {
    type: DataTypes.DATE,
    // 如果要用sqlite原生时间函数做默认值，必须用literal包裹，否则会被当成普通字符串转义
    defaultValue: Sequelize.literal(`(DATETIME('NOW', 'LOCALTIME'))`),
    get() {
      const rawValue = this.getDataValue('createTime')
      // 读取时修正时区偏移，返回本地时区的Date对象
      return rawValue ? new Date(rawValue.getTime() - rawValue.getTimezoneOffset() * 60000) : null
    },
    set(value) {
      // 写入时直接传Date实例，跳过默认的UTC转换
      this.setDataValue('createTime', value instanceof Date ? value : new Date(value))
    }
  }
})

这个方案不受Sequelize版本bug影响，稳定性最高。

方案3：全局重写DATE类型解析器（适合多字段批量处理场景） #

如果项目中存在大量DATE类型字段，逐个配置字段get/set逻辑成本太高，可以在初始化Sequelize之后，直接全局重写DATE类型的解析规则，一次配置全量生效：

const { DataTypes } = require('sequelize')

// 覆盖默认的DATE解析逻辑，关闭强制UTC转换
DataTypes.DATE.parse = (value) => {
  if (!value) return value
  return new Date(value)
}

注意：Node v16之后V8引擎调整了Date对象的时区解析规则，不要直接传入不带时区标识的手写时间字符串给Sequelize，否则可能出现解析偏差，所有时间参数优先传入标准Date实例。

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