如何将Firebase Firestore中的Timestamp转换为日期格式字符串

Firestore 返回的 Timestamp 是存储秒、纳秒级精度的结构化对象，直接调用默认toString()会输出对象结构字符串，无法展示为可读日期，也不能直接传入文本组件渲染，按以下流程处理即可：

• 转换为原生时间对象
  无需手动读取seconds字段做时间换算，官方SDK已封装覆盖时区、精度边界的转换方法，直接调用即可：
  • Web/React Native/小程序（JS/TS环境）：

  // 从文档快照中取出Timestamp类型字段，示例字段名为createTime
  const firestoreTimestamp = doc.data().createTime
  // 转换为JS原生Date对象
  const dateObj = firestoreTimestamp.toDate()
  

  • Flutter/Dart环境：

  // 取出Timestamp字段
  Timestamp firestoreTimestamp = doc.data()['createTime'];
  // 转换为Dart原生DateTime对象
  DateTime dateObj = firestoreTimestamp.toDate();
  

• 格式化后传入文本组件渲染
  不要直接使用原生时间对象的默认toString()返回值，该方法输出格式杂乱不可控，按需求格式拼接或用工具类格式化后再传入Text组件：
  • JS环境原生格式化示例（输出yyyy-MM-dd HH:mm:ss格式）：

  const formatReadableTime = (date) => {
    const year = date.getFullYear()
    const month = String(date.getMonth() + 1).padStart(2, '0')
    const day = String(date.getDate()).padStart(2, '0')
    const hour = String(date.getHours()).padStart(2, '0')
    const minute = String(date.getMinutes()).padStart(2, '0')
    const second = String(date.getSeconds()).padStart(2, '0')
    return `${year}-${month}-${day} ${hour}:${minute}:${second}`
  }
  const displayTime = formatReadableTime(dateObj)
  // 直接传入组件使用：<Text>{displayTime}</Text>
  

  • Dart环境格式化可引入intl包实现：

  import 'package:intl/intl.dart';
  
  final displayTime = DateFormat('yyyy-MM-dd HH:mm:ss').format(dateObj);
  // 传入组件使用：Text(displayTime)
  

常见坑点：如果渲染出的时间和本地时间差8小时，不要手动给时间加时区偏移，优先检查设备本地时区设置。SDK的toDate()方法默认按设备当前时区输出时间，手动修改偏移量会导致跨时区场景下时间显示错误。

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