Firestore日期转UTC异常咨询：时区-3下的Date对象疑问

核心问题在于JavaScript对不同格式日期字符串的解析规则差异，以及本地时区与UTC时区的转换逻辑，以下是具体分析和解决方法：

关键解析规则差异 #

• 使用new Date('YYYY-MM-DD')（不带时间的日期字符串）时，JavaScript会将其解析为UTC时区的当天00:00:00，而非你的本地时区（UTC-3）的00:00:00。
• 使用new Date('YYYY-MM-DD HH:mm:ss')（带时间的字符串）时，JavaScript会将其解析为本地时区的对应时间。

各字段异常原因分析 #

1. date_handover_raw: 2022-06-10 00:00:00.000 #

new Date('2022-06-10')被直接解析为UTC的2022-06-10 00:00:00，Firestore存储UTC时间，因此显示结果就是该值，而非你预期的本地时区00:00:00转UTC后的03:00:00。

2. date_handover_prune: 2022-06-10 02:59:59.000 #

• 原始new Date('2022-06-10')对应本地时区的时间是2022-06-09 21:00:00（UTC-3）。
• pruneDateToEnd函数调用setHours(23)是在本地时区修改时间，将其改为2022-06-09 23:59:59。
• 该本地时间转UTC后就是2022-06-10 02:59:59，因此Firestore显示的是这个UTC时间，日期仍为10号。

3. 正常字段的逻辑验证 #

• date_handover_raw_with_time：本地时区10:00:00转UTC为13:00:00，显示正常。
• date_handover_prune_with_time：本地时区23:59:59转UTC为次日02:59:59，显示正常。

解决方案 #

1. 正确解析本地时区的日期 #

如果需要将YYYY-MM-DD解析为本地时区的当天00:00:00，不要直接使用字符串构造，而是手动构造Date对象：

// 方法1：直接传入年、月（0-based）、日
const localDate = new Date(2022, 5, 10); // 6月对应5

// 方法2：拆分字符串后构造
const [year, month, day] = '2022-06-10'.split('-').map(Number);
const localDate = new Date(year, month - 1, day); // 月份减1转为0-based

2. 统一使用UTC方法修改时间 #

如果想设置日期的“当天末尾”为UTC时区的23:59:59，改用UTC相关的方法，避免时区混淆：

const pruneDateToEndUTC = (date: Date) => {
  const newDate = new Date(date);
  newDate.setUTCHours(23);
  newDate.setUTCMinutes(59);
  newDate.setUTCSeconds(59);
  return newDate;
};

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