README

LaravelNepaliDate is a Laravel package that simplifies the conversion of dates between the Gregorian (English) and Nepali (Bikram Sambat) calendars. This package is a handy tool for projects that require handling dates in both English and Nepali formats, such as websites and applications targeting users in Nepal.

Installation

You can install the package via composer:

composer require anuzpandey/laravel-nepali-date

Optionally, you can publish the config file with:

php artisan vendor:publish --tag="nepali-date-config"

Usage

$engDate = '1996-04-22';
LaravelNepaliDate::from($engDate)->toNepaliDate();
// Result: 2053-01-10

LaravelNepaliDate::from($engDate)->toNepaliDate(format: 'D, j F Y');
// Result: सोम, १० वैशाख २०५३

// Format Specifiers are supported and listed below
LaravelNepaliDate::from($engDate)->toNepaliDate(format: 'D, j F Y', locale: 'en');
// Result: Mon, 10 Baisakh 2053


$nepDate = '2053-01-10';
LaravelNepaliDate::from($nepDate)->toEnglishDate();
// Result: 1996-04-22

LaravelNepaliDate::from($nepDate)->toEnglishDate(format: 'l, jS F Y');
// Result: Sunday, 22nd April 1996

// Format Specifiers are supported and listed below
LaravelNepaliDate::from($nepDate)->toEnglishDate(format: 'l, j F Y', locale: 'np');
// Result: आइतबार, २२ बैशाख १९९६

// Get total days in a month of a year
use Anuzpandey\LaravelNepaliDate\Enums\NepaliMonth;
// month can be NepaliMonth::XXX or month number (1-12)
LaravelNepaliDate::daysInMonth(NepaliMonth::BAISAKH, 2053);
// Result: 31

// Get total days in a year
LaravelNepaliDate::daysInYear(2053);
// Result: 365

Format Specifiers

The following format specifiers are supported for formatting dates:

Y - Year in four digits
y - Year in two digits
m - Month in two digits with leading zero (01-12/०१-१२)
n - Month in one or two digits without leading zero (1-12/१-१२)
M - Month in three letters (Jan-Dec)
F - Month in full name (January-December/बैशाख-चैत्र)
d - Day in two digits with leading zero (01-31/०१-३२)
j - Day in one or two digits without leading zero (1-31/१-३२)
D - Day in three letters (Sun-Sat/आइत-शनि)
l - Day in full name (Sunday-Saturday/आइतबार-शनिबार)
S - Day in two letters (st, nd, rd, th)

Extending Carbon with NepaliDateMixin

Note: This feature has been deprecated as Carbon doesn't support the months having more than 31 days. This feature has been removed from version 2.0.0.

Helper function

// Convert English date to Nepali date (B.S.).
toNepaliDate("1996-04-22") 
// Result: 2053-01-10

// Convert Nepali date to English date (A.D.).
toEnglishDate("2053-01-10") 
// Result: 1996-04-22

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

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

anuzpandey / laravel-nepali-date

Maintainers

Details