date_range_filter 是一个用于 Flutter 的日期范围筛选插件，它允许用户在应用中轻松选择日期范围。以下是如何使用 date_range_filter 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 date_range_filter 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  date_range_filter: ^0.0.3  # 请检查最新版本

然后运行 flutter pub get 来获取依赖。

2. 导入插件

在需要使用 date_range_filter 的 Dart 文件中导入插件：

import 'package:date_range_filter/date_range_filter.dart';

3. 使用 DateRangeFilter 组件

date_range_filter 提供了一个 DateRangeFilter 组件，你可以将其添加到你的 UI 中。以下是一个简单的示例：

import 'package:flutter/material.dart';
import 'package:date_range_filter/date_range_filter.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Date Range Filter Example'),
        ),
        body: DateRangeFilterExample(),
      ),
    );
  }
}

class DateRangeFilterExample extends StatefulWidget {
  @override
  _DateRangeFilterExampleState createState() => _DateRangeFilterExampleState();
}

class _DateRangeFilterExampleState extends State<DateRangeFilterExample> {
  DateTimeRange? _selectedRange;

  @override
  Widget build(BuildContext context) {
    return Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          ElevatedButton(
            onPressed: () async {
              final DateTimeRange? picked = await showDateRangePicker(
                context: context,
                firstDate: DateTime(2020),
                lastDate: DateTime(2025),
                initialDateRange: _selectedRange,
              );
              if (picked != null && picked != _selectedRange) {
                setState(() {
                  _selectedRange = picked;
                });
              }
            },
            child: Text('Select Date Range'),
          ),
          SizedBox(height: 20),
          Text(
            _selectedRange == null
                ? 'No date range selected.'
                : 'Selected Range: ${_selectedRange!.start} to ${_selectedRange!.end}',
          ),
        ],
      ),
    );
  }
}

4. 运行应用

运行你的 Flutter 应用，你将看到一个按钮，点击按钮后会弹出一个日期范围选择器。选择日期范围后，选择的日期范围将显示在屏幕上。

5. 自定义选项

showDateRangePicker 方法提供了多个参数，允许你自定义日期范围选择器的行为，例如：

• firstDate: 允许选择的最早日期。
• lastDate: 允许选择的最晚日期。
• initialDateRange: 初始选择的日期范围。
• currentDate: 当前日期。
• helpText: 选择器顶部的帮助文本。
• cancelText: 取消按钮的文本。
• confirmText: 确认按钮的文本。
• saveText: 保存按钮的文本。
• errorFormatText: 日期格式错误时显示的文本。
• errorInvalidText: 日期无效时显示的文本。
• errorInvalidRangeText: 日期范围无效时显示的文本。

你可以根据需要自定义这些参数。

6. 处理选择结果

在 showDateRangePicker 方法返回的 DateTimeRange 对象中，你可以获取用户选择的开始日期和结束日期，并根据需要进行处理。

if (picked != null) {
  DateTime startDate = picked.start;
  DateTime endDate = picked.end;
  // 处理选择的日期范围
}