如何在Firestore中存储重复日历事件以支持复杂查询

核心文档结构 #

每个日历事件对应Firestore中的一个独立文档，字段设计兼顾RFC5545重复规则兼容性与Firestore查询效率：

{
  // 基础信息
  title: "团队周会",
  description: "每周同步项目进度",
  startDateTime: Timestamp("2024-01-05T10:00:00Z"), // 首次/单次事件开始时间
  endDateTime: Timestamp("2024-01-05T11:00:00Z"),   // 单次事件结束时间，或重复事件的单次时长对应结束时间
  isRecurring: true, // 是否为重复事件
  recurrenceEndDate: Timestamp("2024-12-31T23:59:59Z"), // 重复终止日期（可选，无则无限重复）

  // 重复规则（仅isRecurring为true时生效）
  recurrenceFrequency: "WEEKLY", // 枚举：NONE/DAILY/WEEKLY/MONTHLY/YEARLY
  recurrenceInterval: 1, // 重复间隔（比如每2周则为2）
  recurrenceByDay: ["FR"], // 重复的星期几，用RFC5545缩写：MO/TU/WE/TH/FR/SA/SU
  recurrenceByMonthDay: [], // 每月的具体日期（比如[1,15]表示每月1号、15号）
  recurrenceBySetPos: [], // 每月/每周的第几个（比如[3]表示每月第3个周五）

  // 排除日期
  excludedDates: [Timestamp("2024-02-16T00:00:00Z")] // 取消的重复事件日期
}

常用查询实现 #

1. 查询所有周五举办的事件

需要覆盖单次周五事件和规则包含周五的重复事件：

const targetFridayStart = Timestamp.fromDate(new Date("2024-01-12T00:00:00Z"));
const targetFridayEnd = Timestamp.fromDate(new Date("2024-01-12T23:59:59Z"));

const query = db.collection("events").where(
  firebase.firestore.Query.or(
    // 单次事件：开始时间在周五当天
    firebase.firestore.Query.where("isRecurring", "==", false)
      .where("startDateTime", ">=", targetFridayStart)
      .where("startDateTime", "<=", targetFridayEnd),
    // 重复事件：规则包含周五，且未终止
    firebase.firestore.Query.where("isRecurring", "==", true)
      .where("recurrenceByDay", "array-contains", "FR")
      .where("recurrenceEndDate", ">=", targetFridayStart)
  )
);

const snapshot = await query.get();
// 客户端过滤：排除被取消的周五事件
const validEvents = snapshot.docs.filter(doc => {
  const data = doc.data();
  if (!data.isRecurring) return true;
  return !data.excludedDates?.some(date => date.isEqual(targetFridayStart));
});

2. 查询2024年1月15日的所有事件

需要匹配当天的单次事件、规则匹配当天且未被排除的重复事件：

const targetDateStart = Timestamp.fromDate(new Date("2024-01-15T00:00:00Z"));
const targetDateEnd = Timestamp.fromDate(new Date("2024-01-15T23:59:59Z"));
const targetDayOfWeek = "MO"; // 假设1月15日是周一
const targetMonthDay = 15;

const query = db.collection("events").where(
  firebase.firestore.Query.or(
    // 单次事件
    firebase.firestore.Query.where("isRecurring", "==", false)
      .where("startDateTime", ">=", targetDateStart)
      .where("startDateTime", "<=", targetDateEnd),
    // 重复事件：规则匹配当天，且未终止
    firebase.firestore.Query.where("isRecurring", "==", true)
      .where("recurrenceEndDate", ">=", targetDateStart)
      .where(firebase.firestore.Query.or(
        // 按星期重复且匹配当天星期
        firebase.firestore.Query.where("recurrenceFrequency", "==", "WEEKLY")
          .where("recurrenceByDay", "array-contains", targetDayOfWeek),
        // 按日期重复且匹配当天日期
        firebase.firestore.Query.where("recurrenceFrequency", "==", "MONTHLY")
          .where("recurrenceByMonthDay", "array-contains", targetMonthDay)
      ))
  )
);

const snapshot = await query.get();
// 客户端过滤：排除被取消的事件
const validEvents = snapshot.docs.filter(doc => {
  const data = doc.data();
  if (!data.isRecurring) return true;
  return !data.excludedDates?.some(date => date.isEqual(targetDateStart));
});

优化技巧 #

• 预计算近期事件：对于未来1-3个月的高频查询场景，可通过Cloud Functions定期预计算重复事件的具体日期，存入upcomingDates数组，直接通过array-contains查询，提升效率。
• 客户端过滤复杂规则：对于"每月第3个周五"这类带位置的重复规则，Firestore无法直接查询，可在客户端获取符合频率/星期条件的事件后，再校验日期是否匹配位置规则。
• 索引配置：为常用查询组合创建复合索引，比如isRecurring + recurrenceByDay + recurrenceEndDate，避免查询报错。

内容的提问来源于stack exchange，提问作者pcba-dev