The jalali_calendar package provides a comprehensive solution for working with Persian (Jalali/Shamsi) dates in Flutter applications. It includes a customizable calendar widget, a date picker, and tools to convert between Gregorian and Jalali dates. The package supports holiday detection, making it ideal for apps requiring accurate Persian date handling. Designed with localization in mind, it integrates seamlessly into Persian-language apps or any application needing Jalali date functionality. The package is maintained by flutterfarsi.ir and available via pub.dev.
Use cases
- Persian date selection in forms
- Holiday-aware date tracking
- Gregorian to Jalali date conversion
- Localizing apps for Iranian users
- Building event calendars with Jalali support
Key features
- Jalali calendar UI
- Date picker with holiday support
- Gregorian-Jalali date conversion
- Customizable appearance
- Supports Persian language localization
Suitable for
- Apps targeting Iranian users
- Educational or religious apps using Jalali calendar
- Financial or governmental systems using Persian dates
- Developers needing Persian date utilities
- Flutter projects requiring dual calendar support
Considerations
- Limited platform-specific optimizations
- No built-in internationalization beyond Persian
- Requires manual integration of holiday data
- May need additional styling for custom themes
- Depends on external source code for updates