alkoumi / laravel-hijri-date

Laravel package to Convert laravel date to our Amazing 💝 Hjri date {ummul qura and vice versa} . to look like [ الخميس ، ٢٢ ربيع الآخر ، ١٤٤١ - ٠٧:٤٩ مساءً]

Laravel Hijri Date Ummul Qura Calendar

تحويل التواريخ من و إلى التاريخ الهجري حسب تقويم أم القرى

Laravel package to Convert laravel date to our Amazing 💝 Hjri date {ummul qura and vice versa} . to look like [ الخميس ، ٢٢ ربيع الآخر ، ١٤٤١ - ٠٧:٤٩ مساءً]

Installation for all Laravel Versions 🥳

You can install the package via composer:

composer require alkoumi/laravel-hijri-date

The service provider will automatically get registered. Or you may manually add the service provider in your config/app.php file:

'providers' => [
    // ...
    Alkoumi\LaravelHijriDate\LaravelHijriDateServiceProvider::class,
];

Usage

Get Hijri Date with Ummul Qura calendar in [Your Custom Format]

You can simply get Ummul qura Hijri date directly in Your custom format using Hijri::Date() :

Hijri::Date('format','timestamp') accept tow parameters :

1- First parameter 'format' is required

2- Second parameter 'timestamp' is optianl

    // Choose Your Format Like 'l ، j F ، Y'
    // l => اليوم [الجمعة]
    // j => تاريخ اليوم الهجري [27]
    // m => رقم الشهر االهجري [09]
    // F => اسم الشهر الهجري [رمضان]
    // Y => السنة بالتاريخ الهجري [1442]
    // a => 'ص'
    // A => 'صباحًا'
    // H => الساعات
    // i => الدقائق
    // s => الثواني

    use Alkoumi\LaravelHijriDate\Hijri;

    Hijri::Date('l ، j F ، Y');                         // Without Defining Timestamp It will return Hijri Date of [NOW]  => Results "الجمعة ، 12 ربيع الآخر ، 1442"
    Hijri::Date('Y/m/d');                              // => Results "1442/04/12"
    Hijri::DateIndicDigits('l ، j F ، Y');              // Without Defining Timestamp It will return Hijri Date of [NOW] in Indic Digits => Results "الجمعة ، ١٢ ربيع الآخر ، ١٤٤٢"
    Hijri::DateIndicDigits('Y/m/d');                   //  => Results "١٤٤٢/٠٤/١٢"

    [OR]

    $date = Carbon::now()->addMonth();
    Hijri::Date('l ، j F ، Y', $date);                  // With optional Timestamp It will return Hijri Date of [$date] => Results "الأحد ، 12 جمادى الأول ، 1442"
    Hijri::Date('Y/m/d');                              // => Results "1442/04/12"
    Hijri::DateIndicDigits('l ، j F ، Y', $date);       // With optional Timestamp It will return Hijri Date of [$date] in Indic Digits => Results "الأحد ، ١٢ جمادى الأول ، ١٤٤٢"
    Hijri::DateIndicDigits('Y/m/d');                   //  => Results "١٤٤٢/٠٤/١٢"

Get Hijri Date Ummul Qura Calendar [Short Format]

You can simply get Ummul qura Hijri date directly in Short Format

Hijri::ShortDate('timestamp') accept One Optinal 'timestamp' parameter :

    use Alkoumi\LaravelHijriDate\Hijri;

    Hijri::ShortDate();                 // Without Defining Timestamp It will return Hijri Date of [NOW] => Results "1442/04/12"
    Hijri::ShortDateIndicDigits();      // Without Defining Timestamp It will return Hijri Date of [NOW] in Indic Digits => Results "١٤٤٢/٠٤/١٢"

    [OR]

    $date = Carbon::now()->addMonth();
    Hijri::ShortDate($date);                 // With optional Timestamp It will return Hijri Date of [$date] => Results "1442/05/12"
    Hijri::ShortDateIndicDigits($date);      // With optional Timestamp It will return Hijri Date of [$date] in Indic Digits => Results "١٤٤٢/٠٥/١٢"

Get Hijri Date Ummul Qura Calendar [Medium Format]

You can simply get Ummul qura Hijri date directly in Medium Format

Hijri::MediumDate('timestamp') accept One Optinal 'timestamp' parameter :

    use Alkoumi\LaravelHijriDate\Hijri;

    Hijri::MediumDate();                    // Without Defining Timestamp It will return Hijri Date of [NOW] => Results "الجمعة ، 12 ربيع الآخر ، 1442"
    Hijri::MediumDateIndicDigits();         // Without Defining Timestamp It will return Hijri Date of [NOW] in Indic Digits => Results "الجمعة ، ١٢ ربيع الآخر ، ١٤٤٢"

    [OR]

    $date = Carbon::now()->addMonth();
    Hijri::MediumDate($date);                 // With optional Timestamp It will return Hijri Date of [$date] => Results "الأحد ، 12 جمادى الأول ، 1442"
    Hijri::MediumDateIndicDigits($date);      // With optional Timestamp It will return Hijri Date of [$date] in Indic Digits => Results "الأحد ، ١٢ جمادى الأول ، ١٤٤٢"

Get Hijri Date Ummul Qura Calendar [Full Format]

You can simply get Ummul qura Hijri date directly in Full Format

Hijri::FullDate('timestamp') accept One Optinal 'timestamp' parameter :

    use Alkoumi\LaravelHijriDate\Hijri;

    Hijri::FullDate();                    // Without Defining Timestamp It will return Hijri Date of [NOW] => Results "الجمعة ، 12 ربيع الآخر ، 1442 - 12:34:25 مساءً"
    Hijri::FullDateIndicDigits();         // Without Defining Timestamp It will return Hijri Date of [NOW] in Indic Digits => Results "الجمعة ، ١٢ ربيع الآخر ، ١٤٤٢ - ١٢:٣٤:٢٥ مساءً"

    [OR]

    $date = Carbon::now()->addMonth();
    Hijri::FullDate($date);                 // With optional Timestamp It will return Hijri Date of [$date] => Results "الأحد ، 12 جمادى الأول ، 1442 - 12:34:25 مساءً"
    Hijri::FullDateIndicDigits($date);      // With optional Timestamp It will return Hijri Date of [$date] in Indic Digits => Results "الأحد ، ١٢ جمادى الأول ، ١٤٤٢ - ١٢:٣٤:٢٥ مساءً"

Give Me 💗 Cup of ☕️ Coffee here https://patreon.com/mohammadelkoumi

laravel-hijri-date's Issues

Add custom cast class for laravel >= 7.x

سلام عليكم ورحمة الله وبركاته

Thanks for this amazing package.
I suggest to add custom Casting to convert the dates in get or set automaticlly. as you know the dates should be stored as gregorian in storage but displayed as hijri.

for example in your model add the HijriDate cast:

    /**
     * The attributes that should be cast.
     *
     * @var array
     */
    protected $casts = [
        'created_at' => HijriDate::class,
    ];

• HijriDate:

class HijriDate implements CastsAttributes
{
   /**
    * Cast the given value.
    *
    * @param  \Illuminate\Database\Eloquent\Model  $model
    * @param  string  $key
    * @param  mixed  $value
    * @param  array  $attributes
    * @return mixed
    */
   public function get($model, $key, $value, $attributes)
   {
       // Here convert gregorian to hijri;
       return $value;
   }

   /**
    * Prepare the given value for storage.
    *
    * @param  \Illuminate\Database\Eloquent\Model  $model
    * @param  string  $key
    * @param  array  $value
    * @param  array  $attributes
    * @return mixed
    */
   public function set($model, $key, $value, $attributes)
   {
       // Here convert hijri to gregorian;
       return $value;
   }
}

and if you add some tests it will be great 👍

How to use in blade

Can you provide some example to use it in blade.

Georgian Calendar Arabic support

Is any document available for Georgian Calendar date to Arabic format.

how can i get full month calendar

Salam Alikum,
is it possible to get a full month calendar like for example how can I get Ramadan days when it will start and when it will end,
and thank you for this great package

تحويل الهجري الى ميلادي

سلام عليكم ورحمة الله وبركاته
كيف يتم تحويل التاريخ الهجري الى ميلادي

Calendar

How to create Calendar ?

Hijri Year 1282 not working ?!!!

ErrorException
Undefined offset: -1 

vendor\alkoumi\laravel-hijri-date\src\Hijri.php:144

Any way to set adjustment

Hi,

Is there any method to set adjustments for start of the Hijri months?

Laravel 5.6 issue

Salam Alikum,
I've installed this package, but it doesn't work ! Class Hijri doesn't exist.