Custom Date Picker #

A fully customizable date picker for Flutter that supports both Jalali and Gregorian calendars. This widget allows users to select a single date or a range of dates, making it ideal for various date-selection needs.

Features #

• Dual Calendar Support: Switch seamlessly between Jalali (Persian) and Gregorian calendars.
• Single or Range Selection:
  • Single Date: Choose one date.
  • Range: Select a start and end date.
• Customizable Appearance:
  • Modify colors, borders, day items, and more to match your theme.
• Dynamic Prices: Display additional data, like prices, for specific days.
• Mode Interchangeability: Toggle between single and range modes dynamically.
• Today Button: Quickly jump to the current date.
• Next/Previous Navigation: Navigate through months with ease.
• Custom Day Items: Define your own day widgets for selected, unselected, disabled, and current days.

Installation #

Add this package to your pubspec.yaml:

dependencies:
   dual_custom_date_picker: ^1.2.0

Then run:

flutter pub get

Screenshots #

Single Date Picker #

Range Date Picker #

Usage #

Basic Example #

import 'package:custom_date_picker/custom_date_picker.dart';

CustomDatePicker(
  onDateSelected: (selectedDate) {
    print('Selected Date: $selectedDate');
  },
  datePickerMode: PickerMode.single,
  datePickerType: PickerType.jalali, // or PickerType.dateTime for Gregorian
)

Range Selection Example #

CustomDatePicker(
  datePickerMode: PickerMode.range,
  rangeDates: (null, null), // Initial range dates
  onRangeDateSelected: (startDate, endDate) {
    print('Start Date: $startDate');
    print('End Date: $endDate');
  },
)

Advanced Example with Customization #

CustomDatePicker(
  currentMonth: DateTime.now(),
  initialDate: DateTime(2023, 1, 1),
  lastDate: DateTime(2024, 12, 31),
  onFetchPrices: (month) {
    print('Fetch prices for: $month');
  },
  prices: ['\$100', '\$120', '\$90'], // Example prices
  datePickerType: PickerType.jalali,
  selectedDayColor: Colors.blue,
  primaryColor: Colors.orange,
  needToShowTodayButton: true,
  needToShowChangeCalenderMode: true,
  onDateSelected: (date) {
    print('Selected Date: $date');
  },
  onRangeDateSelected: (start, end) {
    print('Selected Range: $start to $end');
  },
  onChangePickerMode: (newMode) {
    print('Changed mode to: $newMode');
  },
)

Props & Configuration #

Required Parameters #

Optional Parameters #

Appearance Customization #

Additional Features #

• Custom Day Widgets: Override default day widgets with DayItemSection.
• Multi-language Support: Adjusts text direction for RTL (e.g., Persian) or LTR (e.g., English).

License #

This project is licensed under the MIT License. See the LICENSE file for details.