Firestore Timestamp格式不一致问题及有效返回方式咨询

我在Firebase中存储组织受邀用户列表及邀请到期时间戳，客户端通过以下代码判断邀请是否有效：
客户端代码

const inviteStatus = invitee?.validUntil.toDate() >= Date.now() ? 'valid_invitee' : 'expired_invitee'

同时通过Firebase Cloud Functions生成新邀请，创建后返回受邀对象：
Firebase Functions代码

const expiryDate = admin.firestore.Timestamp.now().toDate()
expiryDate.setTime(expiryDate.getTime() + (1000 * 60 * 60 * 24 * 7)) // 7-day expiration

return {
    invitee: {
        validUntil: admin.firestore.Timestamp.fromDate(expiryDate)
    }
}

为保证客户端获取的validUntil格式统一，我返回Firestore的Timestamp而非Date对象，但客户端运行时出现错误：

Uncaught TypeError: invitee.validUntil.toDate is not a function

排查发现：直接从数据库读取的对象在Chrome DevTools中validUntil旁显示“ut”标识，而Cloud Functions返回的对象无此标识。

两种Timestamp对象的差异源于所属SDK不同：

• 直接从Firestore读取的validUntil是Firebase客户端Web SDK创建的firebase.firestore.Timestamp类实例，自带toDate()等封装方法，DevTools中的“ut”标识是该类的专属标记。
• Cloud Functions中使用admin.firestore.Timestamp创建的对象，在通过HTTP函数返回时会被序列化为仅包含_seconds和_nanoseconds字段的普通JSON对象。客户端拿到的是这个普通对象，并非客户端SDK的Timestamp实例，因此无法调用toDate()方法。

方案1：客户端侧转换普通对象为Timestamp实例 #

拿到云函数返回的结果后，用客户端SDK的Timestamp.fromObject()方法将普通对象转换为可调用toDate()的实例：

// 假设从云函数获取到的结果为cloudFunctionResult
const validUntil = firebase.firestore.Timestamp.fromObject(cloudFunctionResult.invitee.validUntil);
const inviteStatus = validUntil.toDate() >= Date.now() ? 'valid_invitee' : 'expired_invitee';

方案2：云函数侧调整返回格式 #

子方案2.1：返回毫秒级时间戳

直接返回到期时间的毫秒数，客户端无需转换即可直接比较：

// 云函数代码修改
const expiryDate = admin.firestore.Timestamp.now().toDate();
expiryDate.setTime(expiryDate.getTime() + (1000 * 60 * 60 * 24 * 7));
return {
    invitee: {
        validUntil: expiryDate.getTime() // 返回毫秒时间戳
    }
};

客户端代码对应修改：

const inviteStatus = invitee?.validUntil >= Date.now() ? 'valid_invitee' : 'expired_invitee';

子方案2.2：使用Callable Cloud Functions（推荐）

如果当前使用的是普通HTTP函数，改为使用Callable Cloud Functions。Firebase会自动处理跨SDK的类型序列化/反序列化，客户端拿到的validUntil直接是客户端SDK的Timestamp实例，可直接调用toDate()。

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