pratiksh/nepalidate

Laravel package to convert AD to BS that can work with carbon.

v2.0.0 2025-05-20 08:16 UTC

This package is auto-updated.

Last update: 2025-05-23 04:36:08 UTC


README

Laravel Nepali Date Converter

Latest Version on PackagistStars Downloads Build Status Scrutinizer Code Quality CodeFactor Larastan License

Laravel package to convert AD to BS that can work with carbon.

Installation

You can install the package via composer:

composer require pratiksh/nepalidate

Usages

By Using Converter Classes.

AD to BS

use Pratiksh\Nepalidate\Services\NepaliDate;

NepaliDate::create(\Carbon\Carbon::now())->toBS(); // 2082-02-04
NepaliDate::create(\Carbon\Carbon::now())->toFormattedEnglishBSDate(); // 4 Jestha 2082, Sunday
NepaliDate::create(\Carbon\Carbon::now())->toFormattedNepaliBSDate(); // ४ जेठ २०८२, आइतवार

By Using Helper Function.

toBS(\Carbon\Carbon::now()); // 2082-02-04
toFormattedEnglishBSDate(\Carbon\Carbon::now()); // 4 Jestha 2082, Sunday
toFormattedNepaliBSDate(\Carbon\Carbon::now()); // ४ जेठ २०८२, आइतवार
toDetailBS(\Carbon\Carbon::now()); // {
    "year": 2082,
    "month": "02",
    "day": "04",
    "dayOfWeek": 1,
  }

BS to AD

use Pratiksh\Nepalidate\Services\EnglishDate;
EnglishDate::create("2082-02-04")->toAD(); //2025-05-18
EnglishDate::create("2082-02-04")->toAD('Y-m-d g:i A'); // 2025-05-18 12:00 AM
EnglishDate::create("2082-02-04")->toCarbon(); // To Carbon instance
EnglishDate::create("2082-02-04")->date; // Carbon instance

By Using Helper Functions

toAD("2082-02-04"); // Carbon instance

Upgrade Guide

This new version include major updates that could break the code.

  • toFormattedBSDate(Carbon $date) changed to toFormattedEnglishBSDate(Carbon $date)
  • toFormattedNepaliDate(Carbon $date) changed to toFormattedNepaliBSDate(Carbon $date)
  • Facades are removed.

Testing

./vendor/bin/pest

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email pratikdai404@gmail.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.