ExpressJS+Sequelize+PostgreSQL DateTime时区存储读取问题

问题 #

我正尝试将日期时间存储到PostgreSQL数据库中，已将数据库时区设置为UTC。

Sequelize模型配置 #

（注：原配置中"public"存在语法错误，修正为schema: "public"）

const definition = {
  id: {
          type: DataTypes.UUID,
          allowNull: false,
          primaryKey: true,
          defaultValue: Sequelize.UUIDV4,
      },
   execution_start_datetime: {
          type: DataTypes.DATE,
          allowNull: false,
      },
      execution_end_datetime: {
          type: DataTypes.DATE,
          allowNull: false,
      },
}
module.exports = (sequelize) => {
    const table = sequelize.define("foo", definition, {
        schema: "public",
        createdAt: 'created_on',
        updatedAt: 'updated_on',
        freezeTableName: true,
    });
    return table;
};

Sequelize配置 #

const sequelize = new Sequelize(
    process.env.DB_NAME,
    process.env.DB_USER,
    process.env.DB_PASSWORD,
    {
        dialect: 'postgres',
        dialectOptions: {
            useUTC: true //for reading from database
        },
        timezone: process.env.DB_TIMEZONE, //to write into the database
        logging: parseInt(process.env.DB_LOGGING) === 1 ? true : false,
        host: process.env.DB_HOST,
        port: process.env.DB_PORT,
        pool: {
            max: parseInt(process.env.DB_POOL_SIZE, 0),
            min: 0,
            acquire: 30000,
            idle: 10000
        }
    });

我的需求是始终以UTC存储数据，读取时返回不带Z的UTC格式ISO8601字符串，由浏览器根据本地时区渲染。但在存储和读取时遇到了问题：

我的机器处于IST时区（UTC+5:30），Postman请求体为：

{
  "execution_start_datetime": "2022-11-08T19:23:51",
  "execution_end_datetime": "2022-11-08T19:23:51"
}

未指定时区，预期Node进程或数据库会自动转为UTC存储。

• 当设置DB_TIMEZONE="-5:30"时，返回结果为：

{
  "execution_start_datetime": "2022-11-08T13:53:51.000Z",
  "execution_end_datetime": "2022-11-08T13:53:51.000Z",
  "updated_on": "2022-11-08T12:55:17.689Z",
  "created_on": "2022-11-08T12:55:17.689Z",
}

• 当设置DB_TIMEZONE="UTC"时，返回结果仍为上述格式（当前本地时间为18:26）。我疑惑为何会使用-5:30的时区偏移。

更奇怪的是，当请求体中的时间字符串添加Z后缀（DB_TIMEZONE="UTC"）：

{
 "execution_start_datetime": "2022-11-08T19:23Z",
 "execution_end_datetime": "2022-11-08T20:23Z"
}

返回结果为：

"execution_start_datetime": "2022-11-08T19:23:00.000Z",
"execution_end_datetime": "2022-11-08T19:23:00.000Z",
"updated_on": "2022-11-08T12:59:45.518Z",
"created_on": "2022-11-08T12:59:45.518Z",

此时created_on和updated_on仍有-5:30的偏移，但execution时间则与存储值一致。

我想了解：

1. Z后缀的作用
2. 是否应该始终传递浏览器时区到后端，由后端添加偏移后转为UTC存储？

回答 #

1. Z后缀的作用 #

Z是ISO8601格式中代表UTC时区的标记（全称Zulu，对应UTC±00:00）。当时间字符串带有Z后缀时，会被明确解析为UTC时间，不会依赖系统或配置的默认时区。

比如2022-11-08T19:23Z直接表示UTC时间的2022年11月8日19点23分，任何解析器都会直接按UTC处理，不会做时区偏移转换。

2. 时区配置问题解析 #

你的核心问题出在Sequelize的时区配置逻辑和未带时区的时间字符串解析规则上：

• 当请求体中的时间字符串不带时区标记时，Sequelize会使用配置的timezone参数解析该时间，将其视为该时区的本地时间，再转换为UTC存储到数据库。
  • 设置DB_TIMEZONE="-5:30"时，Sequelize会把2022-11-08T19:23:51当作UTC-5:30时区的时间，转换为UTC就是2022-11-08T13:53:51Z，和你看到的结果一致。
  • 设置DB_TIMEZONE="UTC"但结果没变，大概率是环境变量未生效，或者Node进程的系统时区（IST，UTC+5:30）被Sequelize fallback使用。
• 关于created_on和updated_on的偏移：这两个字段是Sequelize自动生成的，时间来源是Node进程的系统时间。如果Node运行在IST时区，Sequelize会把系统时间（UTC+5:30）转换为UTC存储，所以返回的UTC时间会比本地时间晚5小时30分，和你看到的结果匹配。

3. 最佳实践 #

方案一：强制前端传递带Z的UTC时间

直接要求前端传递带Z后缀的UTC时间字符串（比如2022-11-08T19:23:51Z），这样无论后端时区配置如何，Sequelize都会直接按UTC解析存储，避免歧义。

方案二：后端统一处理时区转换

如果前端只能传递本地时间（不带时区标记），需要前端同时传递浏览器的时区偏移（比如+05:30），后端接收到后，将时间字符串和时区偏移组合成带时区的时间，再转换为UTC存储。

示例前端请求：

{
  "execution_start_datetime": "2022-11-08T19:23:51",
  "timezone_offset": "+05:30"
}

后端处理逻辑：

const localTime = new Date(`${execution_start_datetime}${timezone_offset}`);
const utcTime = localTime.toISOString(); // 得到带Z的UTC时间，再存储

修正Sequelize配置

确保timezone明确设置为"UTC"，同时检查环境变量是否正确加载。另外，保持dialectOptions.useUTC开启（你已配置），确保从数据库读取时，Sequelize将UTC时间转换为UTC格式返回，而非本地时区。

如果需要返回不带Z的UTC字符串，可以在模型序列化时处理：

table.prototype.toJSON = function() {
  const values = Object.assign({}, this.get());
  // 将带Z的UTC时间转为不带Z的UTC字符串
  values.execution_start_datetime = values.execution_start_datetime.toISOString().slice(0, -1);
  values.execution_end_datetime = values.execution_end_datetime.toISOString().slice(0, -1);
  values.created_on = values.created_on.toISOString().slice(0, -1);
  values.updated_on = values.updated_on.toISOString().slice(0, -1);
  return values;
};

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