使用Node.js QuestDB客户端读取UTC时间戳时Date对象时间异常

问题描述 #

QuestDB存储的所有时间戳均为UTC格式，但通过Node.js客户端读取时，返回的Date对象会错误地将UTC时间值识别为本地时区时间，导致时区偏移。例如：

• 数据库中存储的UTC时间为：2023-09-26T06:18:56.740000Z（对应GMT+0200本地时间8:18）
• 读取后得到的Date对象会把06:18当作本地时间（GMT+0200），调用toISOString()后输出2023-09-26T04:18:56.740Z，与原UTC时间不符。

当前读取代码：

async getData(unitId: string) {
  const client = new Client([...]);
  await client.connect();
  const res = await client.query(
    `select Timestamp from 'myData' where ...`,
  );
  await client.end();
  return res.rows.map((x) => x?.Timestamp); // 返回的Timestamp是带错误时区偏移的Date对象
}

解决方案 #

方案1：SQL查询时直接转换为目标时区字符串

在查询语句中，将UTC时间转换为指定时区的字符串，再在Node.js中解析为正确的Date对象。示例：

-- 查询返回UTC格式字符串和GMT+0200（欧洲中部夏令时）格式字符串
select 
  to_char(Timestamp, 'yyyy-MM-dd"T"HH24:mi:ss.US"Z"') as utc_timestamp,
  to_char(Timestamp AT TIME ZONE 'UTC' AT TIME ZONE 'Europe/Berlin', 'yyyy-MM-dd"T"HH24:mi:ss.US') as cet_timestamp
from 'myData' where ...

Node.js中解析：

async getData(unitId: string) {
  const client = new Client([...]);
  await client.connect();
  const res = await client.query(/* 上述SQL语句 */);
  await client.end();
  
  return res.rows.map(row => {
    // 解析UTC字符串得到正确的UTC Date对象
    const correctUtcDate = new Date(row.utc_timestamp);
    // 若需要GMT+0200的Date对象，可给CET字符串追加时区标识后解析
    const correctCetDate = new Date(`${row.cet_timestamp}+02:00`);
    return correctUtcDate; // 根据业务需求返回对应对象
  });
}

方案2：修正客户端返回的错误Date对象

客户端返回的Date对象本质是把UTC时间值当作本地时间处理，我们可以提取该对象的时间字段，用UTC方法重新构造正确的Date：

async getData(unitId: string) {
  const client = new Client([...]);
  await client.connect();
  const res = await client.query(
    `select Timestamp from 'myData' where ...`,
  );
  await client.end();
  
  return res.rows.map((x) => {
    if (!x?.Timestamp) return null;
    const wrongDate = x.Timestamp;
    // 提取错误Date的时间字段，用Date.UTC构造正确的UTC时间对象
    const correctUtcDate = new Date(Date.UTC(
      wrongDate.getFullYear(),
      wrongDate.getMonth(),
      wrongDate.getDate(),
      wrongDate.getHours(),
      wrongDate.getMinutes(),
      wrongDate.getSeconds(),
      wrongDate.getMilliseconds()
    ));
    return correctUtcDate;
  });
}

构造后的correctUtcDate调用toISOString()会返回与数据库一致的UTC时间字符串。若需要GMT+0200的本地时间展示，可通过toLocaleString()指定时区：

const cetTimeStr = correctUtcDate.toLocaleString('zh-CN', {
  timeZone: 'Europe/Berlin',
  year: 'numeric',
  month: '2-digit',
  day: '2-digit',
  hour: '2-digit',
  minute: '2-digit',
  second: '2-digit',
  fractionalSecondDigits: 3
});

方案3：配置客户端时区（推荐）

部分基于PostgreSQL协议的QuestDB Node.js客户端支持在初始化时指定时区，直接将返回的时间解析为UTC时区的Date对象：

const client = new Client({
  // 其他连接配置（主机、端口、用户名等）
  timezone: 'UTC'
});

配置后，客户端会自动正确解析UTC时间，无需额外处理。

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