Ethiopian Date Picker Flutter Plugin

Banner Design by Firaol Andarge UI/UX Designer

A simplified Ethiopian Date Picker Flutter Plugin with no state management dependencies. Built on the renowned Abushakir plugin, this tool provides comprehensive date picking functionality for Flutter applications with full support for Ethiopian calendar system.

✨ Key Improvements in v 0.0.7

No State Management Required - No BLoC, Provider, or any state management setup needed
Simple Integration - Just import and use with callback functions

Features

✅ Multi-language Support: Amharic, Afan Oromo, and English
✅ Ethiopian Calendar System with Gregorian conversion display
✅ Single Date Selection and Date Range Selection (long press to start range)
✅ Events Calendar with customizable event display and multiple date support
✅ Year Picker with Edit Button - Easy year navigation for all languages (Amharic, Oromo, English)
✅ Gesture Navigation - Swipe between months
✅ Customizable Colors and styling
✅ No External Dependencies - Works out of the box

Quick Start

Installation

Add this to your pubspec.yaml:

dependencies:
  ethiopiandatepickerandconvertor: ^0.0.7

Basic Usage

1. Simple Date Picker

import 'package:ethiopiandatepickerandconvertor/ethiopiandatepickerandconvertor.dart';

// Show date picker dialog
showDialog<List<String>>(
  context: context,
  builder: (_) {
    return SimpleDatePicker(
      displayGregorianCalender: true,
      userLanguage: "am", // "am", "ao", or "en"
      startYear: 1990,
      endYear: 2030,
      todaysDateBackgroundColor: Colors.greenAccent,
      onDatesSelected: (selectedDates) {
        print('Selected dates: $selectedDates');
        // Handle selected dates here
      },
    );
  },
);

2. Calendar with Events

// Navigate to calendar page
Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => SimpleCalendarWithEvents(
      borderColor: Colors.yellow,
      todaysDateColor: Colors.purpleAccent,
      displayGregorianCalender: true,
      userLanguage: "ao", // Supports "am", "ao", "en"
      startYear: 1990,
      endYear: 2030,
      eventsList: [
        // Single date events (format: 'YEAR-MONTH-DAY')
        {'date': '2018-1-15', 'title': 'New Year Event', 'description': 'Ethiopian New Year Celebration'},
        {'date': '2018-2-10', 'title': 'Meeting', 'description': 'Team meeting at 10 AM'},
        {'date': '2018-12-30', 'title': 'Year End Party', 'description': 'End of year celebration'},
        // Multiple dates event
        {'dates': ['2018-5-1', '2018-5-2', '2018-5-3'], 'title': 'Conference', 'note': '3-day event'},
      ],
      onEventTap: (eventData) {
        print('Event tapped: $eventData');
        // Handle event tap
      },
    ),
  ),
);

Features:

Year picker accessible via edit icon button in header for all languages
Events marked with colored borders and event count badges
Tap on event dates to view details
Supports both Gregorian and Ethiopian date display

3. Date Converter (NEW!)

import 'package:ethiopiandatepickerandconvertor/ethiopiandatepickerandconvertor.dart';

// Convert Ethiopian to Gregorian
Map<String, int> gregorian = DateConverter.ethiopianToGregorian(
  year: 2016,
  month: 4,
  day: 15,
);
print('Gregorian: ${gregorian['day']}/${gregorian['month']}/${gregorian['year']}');

// Convert Gregorian to Ethiopian
Map<String, int> ethiopian = DateConverter.gregorianToEthiopian(
  year: 2023,
  month: 12,
  day: 25,
);
print('Ethiopian: ${ethiopian['day']}/${ethiopian['month']}/${ethiopian['year']}');

// String-based conversion with validation
String gregorianStr = DateConverter.ethiopianToGregorianString('15/4/2016');
String ethiopianStr = DateConverter.gregorianToEthiopianString('25/12/2023');

// Get today's Ethiopian date
String today = DateConverter.getTodayEthiopianString();

4. Ethiopian Time Viewer (NEW!)

// Display Ethiopian time with real-time updates
EthiopianTimeViewer(
  language: 'am', // 'am', 'ao', or 'en'
  timeStyle: TextStyle(fontSize: 32, fontWeight: FontWeight.bold),
  backgroundColor: Colors.white,
)

Ethiopian time format:

Day (ቀን): 6 AM - 6 PM Western time
Night (ሌሊት): 6 PM - 6 AM Western time
12-hour format starting at sunrise/sunset

5. Age Calculator (NEW!)

// Calculate age from Ethiopian birthdate
String age = DateConverter.getEthiopianAgeString(
  birthYear: 2000,
  birthMonth: 1,
  birthDay: 1,
  language: 'am', // Returns: "16 ዓመት, 3 ወር, 15 ቀን"
);

// Calculate age from Gregorian birthdate
String gregorianAge = DateConverter.getGregorianAgeString(
  birthYear: 2007,
  birthMonth: 9,
  birthDay: 11,
  language: 'en', // Returns: "16 years, 3 months, 15 days"
);

Language Support

"am" - Amharic (አማርኛ)
"ao" - Afan Oromo (Afaan Oromoo)
"en" - English

API Reference

SimpleDatePicker

Parameter	Type	Description
`displayGregorianCalender`	`bool`	Show Gregorian dates alongside Ethiopian
`userLanguage`	`String`	Language: "am", "ao", or "en"
`startYear`	`int`	Minimum selectable year
`endYear`	`int`	Maximum selectable year
`todaysDateBackgroundColor`	`Color`	Background color for today's date
`onDatesSelected`	`Function(List<String>)`	Callback with selected dates

Year Picker Feature:

Tap the edit icon in the header to open year picker
Available for all languages (Amharic, Oromo, English)
Horizontal scrollable grid layout for easy year selection

Date Selection:

Single tap: Select individual dates
Long press: Start range selection (long press start date, then end date)

SimpleCalendarWithEvents

Parameter	Type	Description
`eventsList`	`List<Map<String, dynamic>>`	Events with date/dates, title, description, note
`onEventTap`	`Function(String)`	Callback when event is tapped
`borderColor`	`Color`	Border color for event dates
`todaysDateColor`	`Color`	Background color for today
`headerBackgroundColor`	`Color?`	Optional header background color
`headerTextColor`	`Color?`	Optional header text color
`monthNavigationColor`	`Color?`	Optional month navigation color
`displayGregorianCalender`	`bool`	Show Gregorian dates alongside Ethiopian
`userLanguage`	`String`	Language: "am", "ao", or "en"
`startYear`	`int`	Minimum selectable year
`endYear`	`int`	Maximum selectable year

Year Picker Feature:

Tap the edit icon in the header to open year picker
Available for all languages (Amharic, Oromo, English)
Horizontal scrollable grid layout for easy year selection

DateConverter (Static Methods)

Method	Parameters	Returns	Description
`ethiopianToGregorian`	`year, month, day`	`Map<String, int>`	Convert Ethiopian to Gregorian
`gregorianToEthiopian`	`year, month, day`	`Map<String, int>`	Convert Gregorian to Ethiopian
`ethiopianToGregorianString`	`dateString`	`String`	Convert with format validation
`gregorianToEthiopianString`	`dateString`	`String`	Convert with format validation
`getTodayEthiopian`	-	`Map<String, int>`	Get current Ethiopian date
`getTodayEthiopianString`	-	`String`	Get formatted Ethiopian date
`getEthiopianAgeString`	`birthYear, birthMonth, birthDay, language`	`String`	Calculate age from Ethiopian date
`getGregorianAgeString`	`birthYear, birthMonth, birthDay, language`	`String`	Calculate age from Gregorian date

EthiopianTimeViewer

Parameter	Type	Description
`language`	`String`	Language: "am", "ao", or "en"
`timeStyle`	`TextStyle?`	Style for time display
`periodStyle`	`TextStyle?`	Style for day/night indicator
`backgroundColor`	`Color?`	Background color
`padding`	`EdgeInsetsGeometry?`	Widget padding

🎯 Live Examples

Example 1: Basic Implementation

See /example folder for basic usage of both widgets with all language support.

Features demonstrated:

🌍 Full Multi-language Support (አማርኛ/Afaan Oromoo/English)
📅 Ethiopian Calendar Integration with Gregorian conversion
📊 Event Calendar showing medication reminders
🔄 Dynamic Language Switching affects calendar interface
✨ Zero State Management - shows how simple integration can be

Key Demo Points:

// Simple date selection for medication schedules
SimpleDatePicker(
  userLanguage: "am", // Switches calendar to Amharic
  displayGregorianCalender: true,
  onDatesSelected: (dates) => saveMedicationSchedule(dates),
)

// Calendar with medication events
SimpleCalendarWithEvents(
  eventsList: medicationEvents,
  userLanguage: currentLanguage, // Dynamic language switching
  onEventTap: (data) => showMedicationReminder(data),
)

// Date converter with age calculator
DateConverterScreen(
  language: currentLanguage,
  // Includes date conversion and age calculation
)

// Ethiopian time display
EthiopianTimeViewer(
  language: currentLanguage,
)

Perfect for:

Cultural calendar applications
Educational projects

👨‍⚕️ Cultural Relevance: Shows how traditional Ethiopian calendar can be seamlessly integrated into modern healthcare applications, making technology more accessible to Ethiopian communities.

🚀 Installation

Add to your pubspec.yaml:

dependencies:
  ethiopiandatepickerandconvertor: ^0.0.7

Then run:

flutter pub get

No additional dependencies required! The library works out of the box without any state management setup.

Migration Guide: No State Management Required

Overview

This library now provides simplified widgets that don't require any state management setup, making it much easier to use.

New Simplified Widgets (Recommended)

1. SimpleDatePicker

A date picker that doesn't require BLoC or any state management.

import 'package:ethiopiandatepickerandconvertor/widgets/simple_date_picker.dart';

// Usage in a dialog
showDialog<List<String>>(
  context: context,
  builder: (_) {
    return SimpleDatePicker(
      displayGregorianCalender: true,
      userLanguage: "am", // "am", "ao", or "en"
      startYear: 1990,
      endYear: 2030,
      todaysDateBackgroundColor: Colors.greenAccent,
      onDatesSelected: (selectedDates) {
        print('Selected dates: $selectedDates');
        // Handle selected dates
      },
    );
  },
);

2. SimpleCalendarWithEvents

A calendar widget for displaying events without state management.

import 'package:ethiopiandatetimepickerandconvertor/widgets/simple_calendar_with_events.dart';

// Usage as a page
Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => SimpleCalendarWithEvents(
      borderColor: Colors.yellow,
      todaysDateColor: Colors.purpleAccent,
      displayGregorianCalender: true,
      userLanguage: "ao",
      startYear: 1990,
      endYear: 2030,
      eventsList: [
        {'date': '2015-12-28', 'title': 'Event 1', 'description': 'Description 1'},
        {'date': '2015-5-1', 'title': 'Event 2', 'description': 'Description 2'},
      ],
      onEventTap: (eventData) {
        print('Event tapped: $eventData');
        // Handle event tap
      },
    ),
  ),
);

Legacy Widgets (Requires BLoC Setup)

The original widgets are still available but require BLoC state management:

AlertDatePicker
CalenderWithEventWidget

To use legacy widgets, add these dependencies to your pubspec.yaml:

dependencies:
  flutter_bloc: ^8.1.3
  meta: ^1.9.1
  equatable: ^2.0.5

Benefits of New Widgets

No State Management Required: No need to set up BLoC providers
Simpler Integration: Just import and use directly
Callback-based: Uses simple callbacks instead of complex state management
Same Features: All the same Ethiopian calendar functionality
Better Performance: Less overhead without state management layer

Language Support

Both widgets support:

"am" - Amharic
"ao" - Afan Oromo
"en" - English

Features

Ethiopian calendar system
Multiple language support
Single date selection
Range date selection (long press to start range)
Gregorian calendar display option
Event display and handling
Customizable colors
Year picker
Gesture navigation (swipe between months)

Migration Steps from 0.0.6 to 0.0.7

Remove BLoC dependencies from your pubspec.yaml (if only using new widgets)
Replace imports:
- Old: import 'package:ethiopiandatepickerandconvertor/widgets/date_picker_alret.dart';
- New: import 'package:ethiopiandatepickerandconvertor/widgets/simple_date_picker.dart';
Remove BlocProvider wrappers from your widget tree
Replace state management with simple callbacks
Update widget parameters to use the new callback-based approach

Your Ethiopian date picker is now much simpler to integrate!

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

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

🙏 Acknowledgments

Built on the renowned Abushakir Ethiopian calendar library
UI/UX Design by Firaol Andarge
Community feedback and testing

📞 Support

For issues, feature requests, or questions:

🐛 Report Issues
📧 Email: [email protected]

Made with ❤️ for the Ethiopian developer community 🇪🇹

Ethiopian Date Picker Flutter Plugin

✨ Key Improvements in v 0.0.7

Features

Quick Start

Installation

Basic Usage

1. Simple Date Picker

2. Calendar with Events

3. Date Converter (NEW!)

4. Ethiopian Time Viewer (NEW!)

5. Age Calculator (NEW!)

Language Support

API Reference

SimpleDatePicker

SimpleCalendarWithEvents

DateConverter (Static Methods)

EthiopianTimeViewer

🎯 Live Examples

Example 1: Basic Implementation

🚀 Installation

Migration Guide: No State Management Required

Overview

New Simplified Widgets (Recommended)

1. SimpleDatePicker

2. SimpleCalendarWithEvents

Legacy Widgets (Requires BLoC Setup)

Benefits of New Widgets

Language Support

Features

Migration Steps from 0.0.6 to 0.0.7

🤝 Contributing

📄 License

🙏 Acknowledgments

📞 Support

Libraries

ethiopiandatepickerandconvertor package