Postgres.js日期范围查询无结果，数据库执行同SQL有数据

核心原因：参数类型不匹配 #

直接传递日期字符串时，Postgres.js会将其作为text类型参数发送给数据库，而你的created_at是timestamp类型，隐式类型转换可能导致时间比较逻辑异常——这就是代码查询返回空结果，但直接执行SQL能得到数据的核心原因（直接执行SQL时数据库会自动解析字符串为timestamp，但参数绑定的规则不同）。

解决办法 #

1. 将日期字符串转为Date对象传递 #

这是最直接的修复方式，Postgres.js会自动把Date对象转换成PostgreSQL兼容的timestamp类型参数，确保类型完全匹配：

let startDate = new Date('2020-01-28 08:39:00');
let endDate = new Date('2020-01-28 08:39:59');

let table = 'testtable';

console.log(
  await sql`
    select
        *
    from
        ${sql(table)}
    where created_at between ${startDate} and ${endDate}
  `
);

2. 处理时区不一致问题 #

如果代码运行环境的时区和数据库时区不同（比如数据库用UTC，代码用本地时区），会导致时间偏移。可以明确使用UTC时间格式：

// 带Z后缀表示UTC标准时间
let startDate = new Date('2020-01-28T08:39:00Z');
let endDate = new Date('2020-01-28T08:39:59Z');

或者在查询中直接指定时区转换：

await sql`
    select *
    from ${sql(table)}
    where created_at between ${startDate}::timestamp AT TIME ZONE 'UTC' and ${endDate}::timestamp AT TIME ZONE 'UTC'
`

3. 解决毫秒精度丢失问题 #

如果created_at字段包含毫秒（比如2020-01-28 08:39:59.123），between ... and 08:39:59会漏掉这些记录，因为字符串/Date对象的秒级精度无法覆盖毫秒。建议改用>=和<的范围查询：

let startDate = new Date('2020-01-28 08:39:00');
// 结束时间设为下一分钟的开始，覆盖所有08:39内的毫秒记录
let endDate = new Date('2020-01-28 08:40:00');

console.log(
  await sql`
    select
        *
    from
        ${sql(table)}
    where created_at >= ${startDate} and created_at < ${endDate}
  `
);

4. 验证实际执行的SQL #

开启Postgres.js的调试模式，查看实际发送给数据库的SQL和参数，确认参数绑定是否符合预期：

sql.debug(true); // 开启调试日志

console.log(
  await sql`
    select
        *
    from
        ${sql(table)}
    where created_at between ${startDate} and ${endDate}
  `
);

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