Vercel/Neon PostgreSQL返回TIMESTAMP而非DATE的问题及解决方法

原因分析 #

1. 驱动类型映射问题：你使用的@vercel/postgres驱动会自动将PostgreSQL的DATE类型转换为JavaScript的Date对象。而JavaScript的Date本质是带UTC时间戳的对象，所以输出时会显示完整的YYYY-MM-DDTHH:MM:SSZ格式。
2. 时区偏移导致日期偏差：Neon/Vercel Postgres默认使用UTC时区，当JavaScript解析Date对象时，会根据运行环境的本地时区进行转换。例如你预期的2025-02-07在UTC时区对应的是前一天的16:00:00，这就是为什么moment.js处理后得到2025-02-06的原因。

解决方案 #

方案1：SQL层面直接格式化返回字符串（推荐） #

在查询时使用PostgreSQL的TO_CHAR函数，直接将DATE字段转换为指定格式的字符串，避免驱动进行类型转换：

SELECT TO_CHAR(start_date, 'YYYY-MM-DD') AS start_date FROM share_buyback_programs;

该查询会直接返回2025-02-07格式的字符串，无需客户端额外处理。

方案2：配置驱动禁用DATE转Date对象 #

通过修改@vercel/postgres客户端的类型解析规则，让DATE字段直接以字符串形式返回：

import { createClient } from '@vercel/postgres';

const client = createClient({
  // 填入你的数据库连接配置
  types: {
    DATE: () => ({
      to: () => null,
      from: (value) => value, // 直接返回数据库返回的字符串值
    }),
  },
});

await client.connect();
const result = await client.sql`SELECT start_date FROM share_buyback_programs`;
console.log(result.rows[0].start_date); // 输出：2025-02-07

方案3：正确处理JavaScript Date对象的时区问题 #

如果需要保留Date对象，可以通过以下方式修正时区偏差：

• 原生JavaScript实现：

  const date = result.rows[0].start_date;
  // 转换为UTC日期字符串
  const formattedDate = new Date(date.setUTCHours(0, 0, 0, 0)).toISOString().split('T')[0];
  console.log(formattedDate); // 输出：2025-02-07
  

• 修正moment.js的用法：

  import moment from "moment";
  
  const result = await sql`SELECT start_date FROM share_buyback_programs`;
  // 使用utc()方法强制以UTC时区解析
  const formattedDate = moment.utc(result.rows[0].start_date).format("YYYY-MM-DD");
  console.log(formattedDate); // 输出：2025-02-07
  

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