PHPackages                             anuzpandey/laravel-nepali-date - 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. [Localization & i18n](/categories/localization)
4. /
5. anuzpandey/laravel-nepali-date

ActiveLibrary[Localization & i18n](/categories/localization)

anuzpandey/laravel-nepali-date
==============================

A Laravel Package to convert English Date (A.D.) to Nepali Date (B.S.) and vice-versa.

3.2.0(3mo ago)1615.5k↓27.9%11[1 PRs](https://github.com/anuzpandey/laravel-nepali-date/pulls)MITPHPPHP ^8.2CI passing

Since Oct 24Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/anuzpandey/laravel-nepali-date)[ Packagist](https://packagist.org/packages/anuzpandey/laravel-nepali-date)[ Docs](https://laravel-nepali-date.anuzpandey.com)[ RSS](/packages/anuzpandey-laravel-nepali-date/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (30)Used By (0)

A Laravel Package to convert Dates from BS and AD.
==================================================

[](#a-laravel-package-to-convert-dates-from-bs-and-ad)

[![Latest Version on Packagist](https://camo.githubusercontent.com/011027e7fdbfd38d14d97479c3da0ddfc325a58688dd9081c5f411add205c50c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616e757a70616e6465792f6c61726176656c2d6e6570616c692d646174652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/anuzpandey/laravel-nepali-date)[![GitHub Tests Action Status](https://camo.githubusercontent.com/36329e2419c2bf322954fa665d4234510839f8e34fb8b453f91e4e00fb3f14e5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f616e757a70616e6465792f6c61726176656c2d6e6570616c692d646174652f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/anuzpandey/laravel-nepali-date/actions?query=workflow%3Arun-tests+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/43bb9faeab96482b80f7afbf1c4c6df475ed35c6f91c7734ebd257dc487fd009/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616e757a70616e6465792f6c61726176656c2d6e6570616c692d646174652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/anuzpandey/laravel-nepali-date)

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
------------

[](#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
-----

[](#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
-----------------

[](#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
-------------------------------------

[](#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

[](#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
```

Blade Directives
----------------

[](#blade-directives)

You can use the Blade directives directly in your views:

```
{{-- Convert English date to Nepali date --}}
@nepaliDate('1996-04-22')
{{-- Result: 2053-01-10 --}}

{{-- With format --}}
@nepaliDate('1996-04-22', 'l, d F Y')
{{-- Result: सोमबार, १० वैशाख २०५३ --}}

{{-- With format and locale --}}
@nepaliDate('1996-04-22', 'l, d F Y', 'en')
{{-- Result: Monday, 10 Baisakh 2053 --}}

{{-- Convert Nepali date to English date --}}
@englishDate('2053-01-10')
{{-- Result: 1996-04-22 --}}

{{-- With format --}}
@englishDate('2053-01-10', 'l, d F Y')
{{-- Result: सोमबार, २२ अप्रिल १९९६ --}}

{{-- With format and locale --}}
@englishDate('2053-01-10', 'l, d F Y', 'en')
{{-- Result: Monday, 22 April 1996 --}}
```

Artisan Commands
----------------

[](#artisan-commands)

Run quick conversions from the CLI:

```
php artisan nepali-date:convert --from=1996-04-22 --to=np
php artisan nepali-date:today
php artisan nepali-date:range --from=2080-01-01 --until=2080-01-05 --calendar=np --to=en
```

Common options:

- `--format=` Output format (defaults to `config('nepali-date.default_format')`)
- `--locale=` Output locale `en` or `np`
- `--strict` Enable stricter date validation
- `--json` Emit JSON output
- `--timezone=` Timezone for `today`

Getting Date as Array
---------------------

[](#getting-date-as-array)

You can get the date components as an array for more flexibility:

```
$engDate = '1996-04-22';
$dateArray = LaravelNepaliDate::from($engDate)->toNepaliDateArray();
// Returns NepaliDateArrayData object with:
// - year: '2053'
// - month: '01'
// - day: '10'
// - npYear: '२०५३'
// - npMonth: '०१'
// - npDay: '१०'
// - dayName: 'Monday'
// - monthName: 'Baisakh'
// - npDayName: 'सोमबार'
// - npMonthName: 'वैशाख'

$nepDate = '2053-01-10';
$dateArray = LaravelNepaliDate::from($nepDate)->toEnglishDateArray();
// Returns similar structure with English date data
```

Supported Date Ranges
---------------------

[](#supported-date-ranges)

CalendarFromToEnglish (A.D.)1944-01-012033-12-31Nepali (B.S.)2000-09-172099-12-30Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [AnuzPandey](https://github.com/anuzpandey)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance81

Actively maintained with recent releases

Popularity37

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 89.8% 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.

###  Release Activity

Cadence

Every ~36 days

Recently: every ~29 days

Total

24

Last Release

98d ago

Major Versions

1.7.1 → 2.0.02024-05-12

2.4.0 → 3.0.02026-02-05

PHP version history (3 changes)1.0.0PHP ^7.4|^8.0

1.1.0PHP ^8.1

2.4.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/d9c599480c31a7dd43d252de6c348ab60e4a8c2e539653b8670ee307e91a69f7?d=identicon)[anuzpandey](/maintainers/anuzpandey)

---

Top Contributors

[![anuzpandey](https://avatars.githubusercontent.com/u/25082225?v=4)](https://github.com/anuzpandey "anuzpandey (106 commits)")[![sagarhumagain](https://avatars.githubusercontent.com/u/37103603?v=4)](https://github.com/sagarhumagain "sagarhumagain (7 commits)")[![dineshuprety](https://avatars.githubusercontent.com/u/51488661?v=4)](https://github.com/dineshuprety "dineshuprety (4 commits)")[![ChandanShakya](https://avatars.githubusercontent.com/u/70548117?v=4)](https://github.com/ChandanShakya "ChandanShakya (1 commits)")

---

Tags

ad-to-bs-datelaravel-ad-to-bslaravel-nepali-datelaravel-nepali-date-converternepali-date-converterlaravelnepali-dateanuzpandeylaravel-nepali-datenepali-date-converter

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/anuzpandey-laravel-nepali-date/health.svg)

```
[![Health](https://phpackages.com/badges/anuzpandey-laravel-nepali-date/health.svg)](https://phpackages.com/packages/anuzpandey-laravel-nepali-date)
```

###  Alternatives

[askdkc/breezejp

Laravel Starter Kit (Livewire+Breeze+Laravel UI+Jetstream)や標準のバリデーションメッセージを全て一瞬で日本語化し、言語切替機能も提供するパッケージです / This package provides all-in-one Japanese translation for Laravel StarterKit (Livewire StarterKit, Breeze, Laravel UI and Jetstream) packages and validation messages with language switching feature.

590244.8k1](/packages/askdkc-breezejp)[statikbe/laravel-filament-chained-translation-manager

A translation manager tool for Laravel Filament, that makes use of the Laravel Chained Translator.

92108.7k](/packages/statikbe-laravel-filament-chained-translation-manager)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[elegantly/laravel-translator

All on one translations management for Laravel

6216.9k](/packages/elegantly-laravel-translator)[smousss/laravel-globalize

Make Laravel projects translatable in a matter of seconds!

2266.3k](/packages/smousss-laravel-globalize)[cosnavel/laravel-query-localization

Query String Localization Package for Laravel

508.2k](/packages/cosnavel-laravel-query-localization)

PHPackages © 2026

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