如何在Firestore中查询起止日期范围内的数据？

问题描述 #

需要从Firestore的Schedule集合中，筛选出用户选中日期落在文档Schedule_Start_Date与Schedule_End_Date范围内的数据。已知Firestore不支持直接对两个不同字段进行跨字段范围查询，询问可行的实现方式。

集合结构示意图

当前临时实现方案 #

1. StreamBuilder数据获取 #

通过arrayContains先筛选出当前员工的所有日程：

StreamBuilder(
  stream: FirebaseFirestore.instance
      .collection('Schedule')
      .where("Schedule_Employees", arrayContains: "$Employee_NAME")
      .snapshots(),
  builder: ((context, AsyncSnapshot<QuerySnapshot> streamSnapshot) {
    // ... 后续逻辑
  }),
)

2. 前端本地筛选 #

在ListView.builder中，将用户选中日期与每个文档的起止日期做对比，根据结果决定是否渲染组件：

Expanded(
  child: ListView.builder(
      itemCount: streamSnapshot.data!.docs.length,
      itemBuilder: (context, index) {
        final DocumentSnapshot documentSnapshot =
            streamSnapshot.data!.docs[index];
        
        // 日期转换与筛选逻辑
        String strDt = formattedDate;
        DateTime Selected_Date =
            DateFormat('dd-MM-yyyy').parse(strDt);
        DateTime start_Date = DateFormat('dd-MM-yyyy').parse(
            "${documentSnapshot['Schedule_Start_Date']}");
      
        DateTime End_Date = DateFormat('dd-MM-yyyy').parse(
            "${documentSnapshot['Schedule_End_Date']}");
       
        bool dateCheck() {
          if (Selected_Date.isBefore(start_Date)) {
            print('before start so cant show');
            return false;
          } else if (Selected_Date.isAfter(start_Date) &&
              Selected_Date.isBefore(End_Date)) {
            print('between start and end date ');
            return true;
          } else if (Selected_Date.isAtSameMomentAs(End_Date) ||
              Selected_Date.isAtSameMomentAs(start_Date)) {
            print('sameee ');
            return true;
          } else if (Selected_Date.isAfter(End_Date)) {
            print('Selected Date is after end date so cant show');
            return false;
          }
          return false;
        }  
      
        return dateCheck()     
            ? NewWidget(
                kbackgroundwhite: kbackgroundwhite,
                documentSnapshot: documentSnapshot)
            : const SizedBox();
      }),
);

方案分析与优化建议 #

当前方案的合理性 #

你的临时方案是可行的，本质是先通过arrayContains过滤出当前员工的所有日程，再在前端本地筛选符合日期范围的数据。但需要注意：

• 如果该员工的日程数据量很大，会导致一次性下载大量数据到客户端，消耗带宽和设备资源。
• 日期字符串解析存在风险：如果Firestore中存储的日期格式和前端解析格式不一致，会抛出异常，建议直接在Firestore中存储Timestamp类型，避免字符串转换错误。

优化方向 #

1. 优化日期存储格式

将Firestore中的Schedule_Start_Date和Schedule_End_Date改为Timestamp类型存储，前端直接转换为DateTime，避免字符串解析问题：

// 从Firestore获取Timestamp转DateTime
DateTime start_Date = (documentSnapshot['Schedule_Start_Date'] as Timestamp).toDate();
DateTime end_Date = (documentSnapshot['Schedule_End_Date'] as Timestamp).toDate();

2. 数据结构优化（适合日期范围较短的场景）

如果日程的日期范围不会太长，可以在Schedule文档中新增一个covered_dates数组，存储该日程覆盖的所有日期（以Timestamp或日期字符串形式）。查询时直接用arrayContains查询选中日期，把筛选逻辑放到Firestore端：

// 查询逻辑改为
stream: FirebaseFirestore.instance
    .collection('Schedule')
    .where("Schedule_Employees", arrayContains: Employee_NAME)
    .where("covered_dates", arrayContains: selectedTimestamp) // selectedTimestamp是选中日期的Timestamp
    .snapshots(),

注意：如果日期范围过长（比如超过30天），这个数组会变得很大，不适合使用。

3. 分拆日程文档（适合长期日程场景）

对于跨月甚至跨年的长期日程，可以将其拆分成按天/周的子文档，每个子文档对应单个日期，查询时直接按日期和员工筛选即可。

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