PHPackages                             etdatepickerlaravel/ethiopian-datepicker - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. etdatepickerlaravel/ethiopian-datepicker

ActiveLibrary[Utility & Helpers](/categories/utility)

etdatepickerlaravel/ethiopian-datepicker
========================================

A comprehensive Laravel package for Ethiopian calendar datepicker with Gregorian calendar conversion

110JavaScript

Since Oct 23Pushed 6mo agoCompare

[ Source](https://github.com/MiheretuTesh/etdatepicker)[ Packagist](https://packagist.org/packages/etdatepickerlaravel/ethiopian-datepicker)[ RSS](/packages/etdatepickerlaravel-ethiopian-datepicker/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Ethiopian Datepicker for Laravel
================================

[](#ethiopian-datepicker-for-laravel)

A comprehensive Laravel package that provides Ethiopian calendar datepicker functionality with Gregorian calendar conversion. Perfect for applications that need to support Ethiopian date selection with accurate conversion between Ethiopian and Gregorian calendars.

Features
--------

[](#features)

- 📅 **Dual Calendar Support**: Switch between Ethiopian and Gregorian calendars
- 🔄 **Accurate Date Conversion**: Precise conversion between Ethiopian and Gregorian dates
- 🌍 **Localization**: Support for Amharic, transliterated, and English day/month names
- 📱 **Responsive Design**: Mobile-friendly interface
- 🎨 **Customizable**: Configurable themes and styling options
- ⚡ **Laravel Integration**: Blade components and Laravel-specific features
- 🔧 **Easy Installation**: Simple composer installation and configuration

Requirements
------------

[](#requirements)

- PHP 7.4 or higher
- Laravel 8.0 or higher

Installation
------------

[](#installation)

### Step 1: Install via Composer

[](#step-1-install-via-composer)

```
composer require etdatepickerlaravel/ethiopian-datepicker
```

### Step 2: Publish Assets (Optional)

[](#step-2-publish-assets-optional)

Publish the configuration file:

```
php artisan vendor:publish --tag=ethiopian-datepicker-config
```

Publish the assets (CSS and JavaScript):

```
php artisan vendor:publish --tag=ethiopian-datepicker-assets
```

Publish the views (if you want to customize them):

```
php artisan vendor:publish --tag=ethiopian-datepicker-views
```

Or publish everything at once:

```
php artisan vendor:publish --tag=ethiopian-datepicker
```

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

#### Using Blade Component

[](#using-blade-component)

```

```

#### With Custom Options

[](#with-custom-options)

```

```

### In Your Blade Layout

[](#in-your-blade-layout)

Make sure to include the styles and scripts in your layout:

```

    @stack('styles')

    @stack('scripts')

```

### Using in Forms

[](#using-in-forms)

```

    @csrf

        Event Date

        @error('event_date')
            {{ $message }}
        @enderror

    Save Event

```

### JavaScript API

[](#javascript-api)

You can also initialize the datepicker programmatically:

```
// Initialize Ethiopian datepicker
const datepicker = new EthiopianDatepicker(document.getElementById('my-date-input'), {
    showGregorian: true,
    showEthiopian: true,
    defaultCalendar: 'ethiopian',
    onChange: function(data) {
        console.log('Ethiopian Date:', data.ethiopian);
        console.log('Gregorian Date:', data.gregorian);
        console.log('Formatted:', data.formatted);
    }
});
```

### PHP Usage

[](#php-usage)

You can also use the Ethiopian calendar conversion in your PHP code:

```
use WorthyERP\EthiopianDatepicker\EthiopianCalendar;

$calendar = new EthiopianCalendar();

// Convert Gregorian to Ethiopian
$ethiopianDate = $calendar->toEthiopian(new DateTime('2024-01-15'));
// Returns: ['year' => 2016, 'month' => 5, 'day' => 6, 'monthName' => 'Tir', ...]

// Convert Ethiopian to Gregorian
$gregorianDate = $calendar->toGregorian(2016, 5, 6);
// Returns: DateTime object

// Get today in Ethiopian calendar
$today = $calendar->today();

// Format Ethiopian date
$formatted = $calendar->format($ethiopianDate, 'full');
// Returns: "Monday, 6 Tir 2016"
```

Configuration
-------------

[](#configuration)

The configuration file `config/ethiopian-datepicker.php` allows you to customize:

- Default calendar type (Gregorian or Ethiopian)
- Date formats
- Language settings
- Styling options
- Validation rules

```
return [
    'default_calendar' => 'gregorian',
    'show_both_calendars' => true,
    'date_format' => [
        'gregorian' => 'Y-m-d',
        'ethiopian' => 'd/m/Y',
    ],
    'language' => [
        'month_names' => [...],
        'weekday_names' => [...],
    ],
    // ... more options
];
```

Component Properties
--------------------

[](#component-properties)

PropertyTypeDefaultDescription`name`string'date'Input name attribute`id`stringnullInput ID (defaults to name)`value`stringnullInitial value`placeholder`string'Select a date...'Placeholder text`required`booleanfalseWhether the field is required`showGregorian`booleantrueShow Gregorian calendar option`showEthiopian`booleantrueShow Ethiopian calendar option`defaultCalendar`string'gregorian'Default calendar to display`classes`string''Additional CSS classesEthiopian Calendar Information
------------------------------

[](#ethiopian-calendar-information)

The Ethiopian calendar has:

- **13 months**: 12 months of 30 days each, plus Pagumen (5 or 6 days)
- **Leap years**: Occur every 4 years (when year % 4 = 3)
- **New Year**: Meskerem 1 (around September 11 in Gregorian)
- **7-8 year difference**: Ethiopian year is 7-8 years behind Gregorian

### Month Names

[](#month-names)

1. Meskerem (መስከረም)
2. Tikimt (ጥቅምት)
3. Hidar (ኅዳር)
4. Tahsas (ታኅሣሥ)
5. Tir (ጥር)
6. Yekatit (የካቲት)
7. Megabit (መጋቢት)
8. Miazia (ሚያዝያ)
9. Ginbot (ግንቦት)
10. Sene (ሰኔ)
11. Hamle (ሐምሌ)
12. Nehase (ነሐሴ)
13. Pagumen (ጳጉሜን)

Examples
--------

[](#examples)

### Example 1: Birth Date Field

[](#example-1-birth-date-field)

```

    Birth Date

```

### Example 2: Event Date with Validation

[](#example-2-event-date-with-validation)

```

```

### Example 3: Ethiopian Only

[](#example-3-ethiopian-only)

```

```

Browser Support
---------------

[](#browser-support)

- Chrome (latest)
- Firefox (latest)
- Safari (latest)
- Edge (latest)
- Mobile browsers

Contributing
------------

[](#contributing)

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

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

Credits
-------

[](#credits)

- Developed by EtDatepickerLaravel
- Ethiopian calendar conversion algorithms based on established conversion methods
- Inspired by the need for accurate Ethiopian date handling in Laravel applications

Support
-------

[](#support)

For issues, questions, or suggestions, please [open an issue](https://github.com/worthyerp/ethiopian-datepicker/issues) on GitHub.

Changelog
---------

[](#changelog)

### Version 1.0.0

[](#version-100)

- Initial release
- Ethiopian calendar support
- Gregorian calendar integration
- Blade component
- JavaScript API
- PHP conversion utilities

###  Health Score

19

—

LowBetter than 10% of packages

Maintenance46

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity13

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/90306c671aa809c6d3a594c5b808d39d0dab7a3f39917533543b0418e5749645?d=identicon)[miheretu\_](/maintainers/miheretu_)

---

Top Contributors

[![MiheretuTesh](https://avatars.githubusercontent.com/u/61537238?v=4)](https://github.com/MiheretuTesh "MiheretuTesh (6 commits)")

### Embed Badge

![Health badge](/badges/etdatepickerlaravel-ethiopian-datepicker/health.svg)

```
[![Health](https://phpackages.com/badges/etdatepickerlaravel-ethiopian-datepicker/health.svg)](https://phpackages.com/packages/etdatepickerlaravel-ethiopian-datepicker)
```

###  Alternatives

[yangbx/captcha-lumen

captcha for lumen

123.8k](/packages/yangbx-captcha-lumen)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)