Flutter中如何获取Firestore文档的服务端上传日期与时间

完全可以直接从Firestore获取文档的服务端上传时间，不需要在Data集合中单独新增日期、时间类的业务字段。Firestore会自动在每个文档的内置元数据中记录服务端生成的时间信息，这类元数据不属于你自定义的业务字段范围，不会破坏你原有集合的数据结构。

每个Firestore文档的元数据默认携带两个和写入时间相关的核心值：

• createTime：文档首次成功创建（即首次上传到服务端）的时间戳，后续对文档的任何修改都不会改变这个值，完全匹配你需要展示“数据上传至服务端的日期与时间”的需求
• updateTime：文档最近一次被修改的服务端时间戳

以上时间值由Firestore服务端在写入请求成功时自动记录和维护，你在创建文档时完全不需要手动传入时间字段，不存在用户本地时间篡改、时区偏差的问题，时间可信度高于客户端自定义传入的时间值。

查询文档时，返回的文档快照对象会自动携带上述元数据，不需要发起额外请求即可读取，也不会产生额外的读写开销。
以JS SDK的典型实现为例：

import { doc, getDoc } from "firebase/firestore";
import { db } from "./你的Firestore初始化文件路径";

// 查询Data集合下指定文档
const docRef = doc(db, "Data", "目标文档ID");
const docSnap = await getDoc(docRef);

if (docSnap.exists()) {
  // 直接读取元数据中记录的首次上传时间
  const serverUploadTimestamp = docSnap.metadata.createTime;
  // 将Timestamp类型转换为页面可展示的本地时间格式
  const displayContent = serverUploadTimestamp.toDate().toLocaleString();
  // 直接将displayContent渲染到页面对应位置即可
}

• 无论你是单次查询文档，还是通过实时监听获取文档更新，返回的快照对象都会携带完整的元数据信息，createTime可以正常读取
• 该时间值不会因为你读取操作产生额外的Firestore计费，因为元数据是随文档查询响应自动返回的，不属于独立的额外查询
• 所有通过Firestore正常写入流程创建的文档，都会自动生成对应的createTime值，历史存量文档也无需做数据迁移即可正常读取

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