Flutter开发中如何从Firestore查询两个指定日期范围内的数据

首先确保你Firestore集合里的invoice_date字段存储的是Firebase Timestamp类型，不要存储为字符串格式，否则范围查询的比对逻辑会失效。

1. 引入必要依赖 #

先确认pubspec.yaml中已经引入cloud_firestore依赖：

dependencies:
  flutter:
    sdk: flutter
  cloud_firestore: ^4.15.0 # 替换为最新稳定版即可

2. 核心查询逻辑实现 #

import 'package:cloud_firestore/cloud_firestore.dart';

// 入参为查询的开始日期、结束日期（均为DateTime类型）
Future<List<Map<String, dynamic>>> getInvoicesByDateRange(DateTime startDate, DateTime endDate) async {
  // 处理结束日期为当天23:59:59，避免漏掉结束日期当天的账单数据
  final processedEndDate = DateTime(endDate.year, endDate.month, endDate.day, 23, 59, 59);
  
  // 将DateTime转换为Firestore支持的Timestamp类型
  final startTimestamp = Timestamp.fromDate(startDate);
  final endTimestamp = Timestamp.fromDate(processedEndDate);

  try {
    final querySnapshot = await FirebaseFirestore.instance
        .collection('invoices') // 替换为你自己的账单集合名称
        .where('invoice_date', isGreaterThanOrEqualTo: startTimestamp)
        .where('invoice_date', isLessThanOrEqualTo: endTimestamp)
        // 可选配置：按账单日期倒序排列，最新的账单排在前面
        .orderBy('invoice_date', descending: true)
        .get();

    // 转换查询结果返回，可根据自己的业务模型替换为实体类转换逻辑
    return querySnapshot.docs.map((doc) {
      final data = doc.data();
      data['doc_id'] = doc.id; // 携带文档ID方便后续修改、删除操作
      return data;
    }).toList();
  } catch (e) {
    print('账单范围查询出错: $e');
    rethrow;
  }
}

3. 调用示例 #

比如查询2024年1月1日到2024年1月31日的所有账单：

void fetchTargetMonthInvoices() async {
  DateTime start = DateTime(2024, 1, 1);
  DateTime end = DateTime(2024, 1, 31);
  List<Map<String, dynamic>> targetInvoices = await getInvoicesByDateRange(start, end);
  // 拿到查询结果后自行处理，比如渲染到列表页面、做统计计算
}

注意事项 #

• 首次运行该查询时，Firebase会提示需要创建复合索引，按照控制台给出的指引创建索引，等待1-2分钟索引生效后即可正常查询
• 如果账单数据量较大，可以搭配limit+startAfter做分页查询，优化加载性能

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