Firebase Firestore服务端存储时间戳错误但本地模拟器正常，如何解决？

我长期寻找该问题的解决方案，始终未定位到根因。当前项目的部分模块依赖各类日期时间计算能力，用户会在CSV文件中录入日期时间，示例如下：

我使用momenttz库读取文件并格式化日期时间，对应代码如下：

const getTimestamp = (time_array,date_object) => {
    let year = date_object.substr(0,4);
    let month = (parseInt(date_object.substr(4,2)) -1);
    let date = date_object.substr(6,2);

    let hour = parseInt(time_array[0]);
    let minute = parseInt(time_array[1]);
    let second = parseInt(time_array[2]);
    console.log("hr ",hour, " minutes ", minute, " second ", second);

    let momentTime = moment.utc({ years:year, months:month, date:date, hours:hour, minutes:minute, seconds:second});
    console.log("momentTime",momentTime); // 日志输出和CSV中记录的时间一致：Moment<2021-09-21T13:25:00Z>
     const firestore = admin.firestore;
    return firestore.Timestamp.fromDate(momentTime.valueOf());
}

我将生成的时间戳传入Firebase的新增/更新查询，该逻辑在本地模拟器中运行完全正常，例如传入13:25:00时，本地Firestore模拟器会存储完全一致的时间。但线上环境的Firestore控制台中存储的时间存在错误，比传入的时间多5小时30分钟，例如传入13:25:00会存储为18:55:00 UTC+5:30，控制台展示如下：

我曾尝试将系统时区修改为客户所在的东京时区，验证是否为时区导致的问题，结果存储的时间依然比客户时间多9.5小时。

注：我已知晓Firestore不涉及时区处理，会以epoch格式存储时间戳，请问该如何解决该问题？

根因定位 #

• Firestore控制台的显示逻辑会自动将存储的epoch时间戳转换为当前访问设备的系统时区展示，你看到的UTC+5:30时间仅为显示格式，不代表实际存储的时间戳数值。本地模拟器默认使用你本机时区展示时间，所以看起来和输入一致，属于正常现象。
• 如果CSV中用户录入的是对应业务地区的当地时间（比如东京时区的13:25），你当前代码直接调用moment.utc()将该时间当作UTC时间解析，会导致生成的时间戳本身存在时区偏移误差。

修复步骤 #

1. 验证存储的时间戳准确性
   写入数据前打印momentTime.valueOf()得到的毫秒级时间戳，你可以自行将该数值转换为UTC时间比对，若和你预期存储的UTC时间一致，则存储逻辑没有问题，无需修改写入逻辑，仅需在所有前端展示时间的场景，统一按照业务要求的时区转换后展示即可。
2. 修正时区解析逻辑（若CSV为当地时间）
   如果CSV中录入的是指定时区的当地时间，需要用moment-timezone的时区解析方法替换原有的UTC解析逻辑，示例如下（以东京时区为例）：

// 需提前引入moment-timezone依赖
const moment = require('moment-timezone');

const getTimestamp = (time_array, date_object, businessTimezone = 'Asia/Tokyo') => {
    const year = date_object.substr(0,4);
    const month = parseInt(date_object.substr(4,2)) - 1;
    const date = date_object.substr(6,2);
    const hour = parseInt(time_array[0]);
    const minute = parseInt(time_array[1]);
    const second = parseInt(time_array[2]);
    
    // 先按业务时区解析时间，再转成UTC时间戳存储
    const momentTime = moment.tz({ years: year, months: month, date: date, hours: hour, minutes: minute, seconds: second }, businessTimezone);
    return admin.firestore.Timestamp.fromDate(momentTime.toDate());
}

3. 统一展示规范
   禁止直接使用Firestore控制台显示的时间作为正确性判断标准，所有时间展示场景都需要明确指定转换时区，避免不同设备时区不同导致的显示差异。

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