calendar_picker_ghe #

A lightweight, customizable Flutter date picker supporting:

• 🗓️ Gregorian Calendar
• 🕌 Hijri Calendar
• 🌍 Ethiopian Calendar

Easily switch between calendars using a unified API with a clean, customizable dialog interface.

✨ Features #

• 🔁 Easy month/year navigation via dropdowns and arrows
• ✅ Highlights for today’s date and selected date
• 📆 Configurable year range: firstYear, lastYear, and initialYear
• 🌐 Multilingual support: English (default), Amharic, Arabic
• 🎯 Unified function: showUnifiedDatePicker(...)
• 🌍 Clean, extensible codebase for integrating other calendars
• 📱 Responsive for small and large screens

📸 Screenshots #

🇬🇧 English #

Gregorian	Ethiopian	Hijri

🇪🇹 Amharic #

Gregorian	Ethiopian	Hijri

🇸🇦 Arabic #

Gregorian	Ethiopian	Hijri

🚀 Getting Started #

📦 Installation #

Run this command in your Flutter terminal:

flutter pub add calendar_picker_ghe

This will add the following line to your pubspec.yaml and fetch the package:

dependencies:
calendar_picker_ghe: ^2.2.0

📥 Import the Package #

import 'package:calendar_picker_ghe/calendar_picker.dart';

🧪 Usage #

 
final pickedDate = await showUnifiedDatePicker(
context: context,
calendarType: CalendarType.ethiopian, // or .hijri / .gregorian
initialYear: 2015,
firstYear: 2000,
lastYear: 2030,
);

🧭 Full Function Signature #

Future<dynamic> showUnifiedDatePicker({
  required BuildContext context,
  required CalendarType calendarType,
  required int initialYear,
  required int firstYear,
  required int lastYear,
  String locale = 'en', // Optional: 'en', 'am', or 'ar'
});

📘 Field Descriptions #

🌐 Locale Options #

By default, the date picker uses English. Use the locale parameter to switch language:

✅ Usage Examples (All 9 Possibilities) #

// Gregorian - English (default)
await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.gregorian,
  initialYear: DateTime.now().year,
  firstYear: 1900,
  lastYear: 2100,
);

// Gregorian - Amharic
await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.gregorian,
  initialYear: DateTime.now().year,
  firstYear: 1900,
  lastYear: 2100,
  locale: 'am',
);

// Gregorian - Arabic
await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.gregorian,
  initialYear: DateTime.now().year,
  firstYear: 1900,
  lastYear: 2100,
  locale: 'ar',
);

// Ethiopian - English
await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.ethiopian,
  initialYear: Ethiopian.now().year,
  firstYear: 1900,
  lastYear: 2100,
);

// Ethiopian - Amharic
await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.ethiopian,
  initialYear: Ethiopian.now().year,
  firstYear: 1900,
  lastYear: 2100,
  locale: 'am',
);

// Ethiopian - Arabic
await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.ethiopian,
  initialYear: Ethiopian.now().year,
  firstYear: 1900,
  lastYear: 2100,
  locale: 'ar',
);

// Hijri - English
await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.hijri,
  initialYear: Hijri.now().year,
  firstYear: 1358,
  lastYear: 1500,
);

// Hijri - Amharic
await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.hijri,
  initialYear: Hijri.now().year,
  firstYear: 1358,
  lastYear: 1500,
  locale: 'am',
);

// Hijri - Arabic
await showUnifiedDatePicker(
  context: context,
  calendarType: CalendarType.hijri,
  initialYear: Hijri.now().year,
  firstYear: 1358,
  lastYear: 1500,
  locale: 'ar',
);

📘 Notes #

To set the initial year dynamically:

initialYear: DateTime.now().year, // Gregorian
initialYear: Hijri.now().year,    // Hijri (requires Hijri converter)
initialYear: Ethiopian.now().year, // Ethiopian (requires Ethiopian converter)

📝 License #

This project is licensed under the terms of the Apache License 2.0.

📬 Contact #

For questions, feedback, or contributions:

📧 Email: halidawell00@gmail.com