API返回带时区日期转UI用户所选时区失败，寻求解决方案

问题根源 #

直接用new Date(dateStr)解析带CST的日期字符串时，CST存在歧义（可对应美国中部时间UTC-6、中国标准时间UTC+8等），不同运行环境的解析结果不一致，导致后续时区转换完全错误。

解决方案 #

先手动解析API返回的日期字符串，明确原始时区的偏移量，再转换到用户选择的时区：

1. 正确解析API日期字符串 #

function parseAPIDate(dateStr) {
  // 拆分日期、时间、时区部分
  const [datePart, timeWithPeriod, , tz] = dateStr.split(/ at | /);
  const [month, day, year] = datePart.split('/').map(Number);
  const [time, period] = timeWithPeriod.split(' ');
  let [hour, minute] = time.split(':').map(Number);

  // 转换12小时制为24小时制
  if (period === 'p.m.' && hour !== 12) hour += 12;
  if (period === 'a.m.' && hour === 12) hour = 0;

  // 确认API返回的CST对应的时区偏移（这里以美国中部标准时间UTC-6为例）
  // 若为中国标准时间则改为8*60，澳大利亚中部时间改为9.5*60
  const tzOffsetMinutes = -6 * 60;

  // 构造UTC时间并加上偏移，得到正确的时间戳
  const utcTimestamp = Date.UTC(year, month - 1, day, hour, minute) + tzOffsetMinutes * 60 * 1000;
  return new Date(utcTimestamp);
}

2. 转换为用户时区格式 #

function formatToUserTimezone(apiDateStr, userTz) {
  const correctDate = parseAPIDate(apiDateStr);
  const options = {
    timeZone: userTz,
    day: "numeric",
    month: "numeric",
    year: "numeric",
    hour: "numeric",
    minute: "2-digit",
    hour12: true
  };
  return new Intl.DateTimeFormat("en-US", options).format(correctDate);
}

使用示例 #

// API返回的日期字符串
const apiDate = "12/23/2023 at 03:31 a.m. CST";
// 用户选择的时区（比如澳大利亚东部时间）
const userTimezone = "Australia/Sydney";
// 输出：12/23/2023 at 7:31 p.m.
console.log(formatToUserTimezone(apiDate, userTimezone));

关键注意事项 #

• 必须确认API返回的CST具体指代哪个时区，对应调整tzOffsetMinutes的值；
• userTz需使用IANA时区标识符（如"America/Chicago"、"Asia/Shanghai"），而非缩写。

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