客户端与服务器间时区处理问题（基于Luxon与PostgreSQL）

核心原则是以UTC为统一基准处理时间范围，彻底摆脱对服务器或数据库本地时区的依赖，具体方案如下：

• 强制使用timestamptz存储时间
  确保PostgreSQL的时间字段类型为timestamptz（带时区时间戳），而非timestamp。timestamptz会自动将写入的时间转换为UTC存储，查询时能精准处理时区转换，从根源避免时区存储混乱。

• 基于业务时区生成UTC查询范围
  不要硬编码时区偏移，改用具体的时区标识符（比如America/Sao_Paulo对应UTC-3，自动适配夏令时），把目标业务日期转换为UTC的当日起始和结束时间，再用这个范围查询数据库：

  // 从环境变量读取业务时区，避免硬编码
  const appTimezone = process.env.APP_TIMEZONE || 'America/Sao_Paulo';
  // 用户指定的业务日期（比如2022-11-15）
  const targetDate = luxon.DateTime.fromISO('2022-11-15', { zone: appTimezone });
  // 转换为UTC的当日首尾时间
  const startUTC = targetDate.startOf('day').setZone('utc');
  const endUTC = targetDate.endOf('day').setZone('utc');
  

  对应的PostgreSQL查询语句：

  SELECT * FROM your_table
  WHERE created_at >= $1 AND created_at <= $2;
  

  不管数据库服务器是UTC-3还是UTC+0，这个查询都能精准命中目标业务日期的全天数据。

• 客户端传递日期时明确时区
  客户端若要传递查询日期（比如用户界面选择的日期），需同时告知服务端该日期所属的业务时区，或者直接让客户端用Luxon生成UTC时间范围后再传递，避免服务端因猜测时区出现偏差。

• 统一环境时区配置
  将业务时区配置在环境变量中（本地和托管环境共用同一配置），所有时间处理逻辑都依赖这个配置，无需根据环境修改代码，彻底规避硬编码偏移的问题。

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