如何将用户输入日期时间转换为正确的Firestore Timestamp值

问题根源 #

1. 直接使用Timestamp.fromDate(new Date('2023-03-03 18:06:00'))时，JavaScript解析不带时区的日期字符串规则不统一：部分环境会将其视为UTC时间，而你需要的是Asia/Calcutta（印度，UTC+5:30）时区的18:06，若被当成UTC的18:06，转成印度时区就是23:36（11:36 PM），导致显示错误。
2. 用toLocaleString处理后传入Timestamp.fromDate()报错，是因为toLocaleString返回的是格式化后的字符串，而该方法仅接受Date对象作为参数。

解决方案 #

方案1：给输入字符串添加时区标识 #

明确指定输入时间属于Asia/Calcutta时区，让JS正确解析：

const inputDateStr = "2023-03-03 18:06:00";
// 转换为带印度时区的ISO格式
const timeZoneAwareStr = inputDateStr.replace(' ', 'T') + "+05:30";
const targetDate = new Date(timeZoneAwareStr);
const firestoreTimestamp = Timestamp.fromDate(targetDate);
// 将timestamp写入Firestore对应字段

这样生成的Timestamp存储的UTC时间为12:36（18:06 - 5:30），在Firestore控制台切换到Asia/Calcutta时区查看时，会显示3/3/23, 06:06 PM，完全符合预期。

方案2：手动计算UTC时间 #

将输入时间视为Asia/Calcutta时区时间，手动减去时区偏移得到UTC时间：

const inputDateStr = "2023-03-03 18:06:00";
const localDate = new Date(inputDateStr);
// 印度时区偏移为+5小时30分钟，转换为毫秒后减去
const utcTime = localDate.getTime() - (5 * 60 + 30) * 60 * 1000;
const utcDate = new Date(utcTime);
const firestoreTimestamp = Timestamp.fromDate(utcDate);

方案3：用Intl.DateTimeFormat解析（兼容多格式输入） #

如果输入日期格式不固定，用国际化API解析更可靠：

const inputDateStr = "2023-03-03 18:06:00";
const formatter = new Intl.DateTimeFormat('en-US', {
  year: 'numeric', month: '2-digit', day: '2-digit',
  hour: '2-digit', minute: '2-digit', second: '2-digit',
  timeZone: 'Asia/Calcutta'
});
// 解析日期各部分
const parts = formatter.formatToParts(new Date(inputDateStr));
const dateParts = parts.reduce((acc, part) => {
  if (part.type !== 'literal') acc[part.type] = part.value;
  return acc;
}, {});
// 构造带时区的ISO字符串
const isoStr = `${dateParts.year}-${dateParts.month}-${dateParts.day}T${dateParts.hour}:${dateParts.minute}:${dateParts.second}+05:30`;
const targetDate = new Date(isoStr);
const firestoreTimestamp = Timestamp.fromDate(targetDate);

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