Next.js API从AWS Redshift取数时区不一致问题排查

问题原因 #

DataGrip会直接将Redshift的DATE类型字段显示为YYYY-MM-DD格式的字符串；而Next.js使用的数据库客户端（如pg、node-redshift等）会把DATE类型解析为JavaScript的Date对象，当API序列化返回数据时，Date对象会自动转为带时区的ISO格式字符串（如2024-02-01T18:30:00.000Z）。你之前尝试在查询中设置时区无效，是因为Redshift的DATE类型本身不存储时区信息，设置时区仅影响查询时的时间计算，无法改变客户端对DATE字段的解析逻辑。

解决方案 #

1. 在SQL查询中直接格式化日期（推荐） #

使用Redshift的TO_CHAR函数将DATE字段转为指定格式的字符串，这样返回的结果直接是纯日期字符串，不会被客户端解析为Date对象：

SELECT 
  TO_CHAR(orderMonth, 'YYYY-MM-DD') AS orderMonth,
  repeatC,
  newC
FROM your_table;

2. 在Next.js API中处理返回数据 #

如果不想修改SQL，可以在API层将Date对象转为YYYY-MM-DD格式的字符串：

// 假设查询得到的结果是rows数组
const formattedRows = rows.map(row => ({
  ...row,
  orderMonth: row.orderMonth.toISOString().split('T')[0]
}));

// 或者更严谨的格式化方式
const formatDate = (date) => {
  const year = date.getFullYear();
  const month = String(date.getMonth() + 1).padStart(2, '0');
  const day = String(date.getDate()).padStart(2, '0');
  return `${year}-${month}-${day}`;
};

const formattedRows = rows.map(row => ({
  ...row,
  orderMonth: formatDate(row.orderMonth)
}));

3. 配置数据库客户端，直接返回日期字符串 #

针对pg这类客户端，可以通过设置类型解析器，让客户端直接将Redshift的DATE类型返回为原始字符串，不转为Date对象：

const { types } = require('pg');
// Redshift的DATE类型OID为1082，直接返回原始值
types.setTypeParser(1082, (value) => value);

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