Download the PHP package mammesat/filament-ethiopic-calendar without Composer

Ethiopian Calendar & Time Engine for Filament

Finally, Ethiopian dates and time — done right in Filament.

Production-ready Ethiopian calendar and Ethiopian time support for Laravel + Filament v5.

🚀 Quick Start (30 seconds)

Install

Use

That's it. No configuration required. Works out of the box.

🧠 What ->ethiopic() does

Calling ->ethiopic() automatically configures:

You do not need to set these manually. One method handles everything.

👀 Expected UI

After adding ->ethiopic()->withTime(), you should see:

• ✅ Ethiopian calendar popup with Amharic month and day names
• ✅ Ethiopian time display (e.g., ጠዋት 4:00 instead of 10:00 AM)
• ✅ Helper preview below the field showing the Ethiopian date/time
• ✅ "Stored as: Gregorian" note so developers know the DB format
• ✅ Standard Filament DateTimePicker UI (no custom dropdowns)

📦 All Three Component Types

Form Field

Table Column

Infolist Entry

All three share the same API. Use ->ethiopic(), ->dual(), or ->gregorian() on any of them.

✨ Interactive Tooltips

Instantly provide context without cluttering your UI. Enable a hover tooltip that shows the "opposite" calendar system.

• Displaying Gregorian? Hover to see Ethiopic date + Ethiopian time.
• Displaying Ethiopic? Hover to see Gregorian equivalent.

Available on EthiopicDateColumn and EthiopicDateEntry.

[!NOTE] Tooltips are automatically disabled in dual() mode since both calendar systems are already visible.

⚙️ Optional Customization

Most users only need ->ethiopic(). But if you need more control:

Dual mode (Ethiopian + Gregorian side by side)

Output: Apr 21, 2026 (ሚያዝያ 13, 2018) 10:00 AM (ጠዋት 4:00)

Gregorian mode

English transliteration

Custom helper text

Date only (no time picker)

🔧 Global Configuration (Optional)

Most projects don't need this. But if you want to set defaults globally:

This publishes config/ethiopic-calendar.php where you can set:

• display_mode — default display mode (ethiopic_amharic, ethiopic_english, gregorian, dual)
• calendar_system — which picker grid to render (ethiopic, gregorian)
• time_mode — default time system (gregorian, ethiopian, dual)
• calendar_locale — default popup language (am, en)
• with_time — enable time globally (true / false)
• timezone — defaults to Africa/Addis_Ababa

Per-field settings (e.g., ->ethiopic()) always override global config.

Per-tenant calendars (multi-tenant apps)

calendar_system and display_mode can both be resolved per request with a closure, so each tenant sees its own calendar. Register them once, for example in a service provider:

calendar_system switches the date picker; display_mode switches every column, entry and formatter call that has no explicit mode. Stored values are always Gregorian, whichever calendar is displayed.

❗ Common Mistakes

Using Filament's DateTimePicker instead of EthiopicDateTimePicker

Assets not loading

If the calendar doesn't render properly after install:

Manually configuring what ->ethiopic() already does

📐 Formatter API

For use outside Filament components (e.g., Blade views, exports, notifications):

🔄 Backward Compatibility

Legacy display mode values (e.g., amharic_no_week, clean_gregorian, hybrid) are still fully supported and automatically normalized at runtime. You do not need to migrate existing database records or settings.

📸 Screenshots

• Settings / Configuration Panel

• Form Picker + helper output

• Table output with dual display

• Infolist scenarios

License

MIT