🇪🇹 Ethiopian Date & Time Picker

A professional Ethiopian calendar date and time picker with accurate Gregorian ↔ Ethiopian conversion. Pure JavaScript, zero dependencies.

Features

✅ Tiered Navigation (Year → Month → Day) • ✅ Age Calculation • ✅ Accurate conversion • 🌍 Bilingual (Amharic/English) • 🌅 Native Ethiopian Time (6h offset) • 🌙 Dark mode • 🎉 Holiday highlighting • ⌨️ Keyboard navigation • ♿ Accessible • 📱 Responsive

Installation

NPM:

npm install @bekim_2121/ethiopian-datepicker

CDN:

<!-- Replace VERSION with the latest version (e.g., 1.1.5) -->
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@bekim_2121/ethiopian-datepicker@VERSION/dist/ethiopian-datepicker.css">
<script src="https://cdn.jsdelivr.net/npm/@bekim_2121/ethiopian-datepicker@VERSION/dist/ethiopian-datepicker.js"></script>

Quick Start

<!-- Input element -->
<input type="text" id="datepicker" placeholder="ቀን ይምረጡ..." readonly>

<script>
  // Initialize Date Picker
  new EthiopianDatePicker('#datepicker', {
    locale: 'am',              // 'am' or 'en'
    darkMode: false
  });
</script>

Special Features

📅 Tiered Navigation (New!)

Skip the "tired" month-by-month clicking.

• Click the Year to select from a grid.
• Click the Month to jump to any Ethiopian month.
• Selecting a year automatically prompts for the month.

🎂 Age Calculation

Accurately calculate age in Ethiopian years, months, and days, correctly handling Pagume (the 13th month).

const calendar = new EthiopianCalendar();
const age = calendar.calculateAge(2010, 5, 4); 
// Returns: { years: 7, months: 6, days: 10 }

Configuration

new EthiopianDatePicker('#input', {
  locale: 'am',                    // Language ('am' or 'en')
  darkMode: false,                 // Dark mode theme
  highlightHolidays: true,         // Highlight Ethiopian holidays
  minDate: new Date(),             // Disable previous dates
  maxDate: new Date('2030-12-31'), // Max selectable date
  onChange: (date) => {
    console.log('Ethiopian:', date.ethiopian);
    console.log('Gregorian:', date.gregorian);
    console.log('Formatted:', date.formatted);
  }
});

Time Picker

new EthiopianTimePicker('#input', {
  useEthiopianTime: true, // Native 12h cycle (Sunrise = 12:00)
  twelveHour: true,       // Day/Night labels (ረፋድ, ማታ, etc.)
  darkMode: false,
  onChange: (time) => console.log(time.ethiopian.formatted)
});

API

| Method | Description | | --- | --- | | getSelectedDate() | Returns the currently selected date object. | | setDate(y, m, d) | Sets the date programmatically. | | open() / close() | Manually control picker visibility. |

Ethiopian Calendar Utilities

const calendar = new EthiopianCalendar();

// Convert dates
const ethDate = calendar.gregorianToEthiopian(new Date());
const gregDate = calendar.ethiopianToGregorian(2017, 5, 4);

// Format dates
const formatted = calendar.formatDate(2017, 1, 1, 'am'); // "1 መስከረም 2017"

Ethiopian Holidays

The picker automatically highlights and labels major Ethiopian holidays:

• እንቁጣጣሽ (New Year)
• መስቀል (Finding of the True Cross)
• ገና (Christmas)
• ጥምቀት (Epiphany)
• አድዋ (Victory of Adwa)
• ፋሲካ (Easter)
• And more...

Browser Support

Chrome, Firefox, Safari, Edge (latest versions).

License

MIT © Bereket

Built with ❤️ for the Ethiopian community