PHPackages                             surazdott/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. surazdott/nepali-date

ActivePackage

surazdott/nepali-date
=====================

Laravel package to convert English date into Nepali.

v1.1.3(11mo ago)9340[1 issues](https://github.com/surazdott/nepali-date/issues)MITPHPPHP ^8.1CI passing

Since Apr 4Pushed 11mo ago1 watchersCompare

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

READMEChangelog (5)Dependencies (4)Versions (6)Used By (0)

Laravel Nepali Date
===================

[](#laravel-nepali-date)

 [![Laravel Nepali Date](https://raw.githubusercontent.com/surazdott/nepali-date/main/art/image.png)](https://raw.githubusercontent.com/surazdott/nepali-date/main/art/image.png)

[![GitHub Workflow Status (main)](https://camo.githubusercontent.com/30d4d6032737e5cc0f9077e64ae644a08f11b3d3584c9bc6af64d57d720aa761/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f737572617a646f74742f6e6570616c692d646174652f74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d726f756e642d737175617265)](https://github.com/surazdott/nepali-date/actions) [![Latest Version](https://camo.githubusercontent.com/024f19c786baa669266ac27b5c09efce7dc45eb7dc4a1b39f932cf75c3f50305/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f737572617a646f74742f6e6570616c692d64617465)](https://packagist.org/packages/surazdott/nepali-date) [ ![CodeFactor](https://camo.githubusercontent.com/749cd7768d8df3d2007419ee7b8e95893ec5f4c1034b89267c2c75dd8930ac8a/68747470733a2f2f7777772e636f6465666163746f722e696f2f7265706f7369746f72792f6769746875622f737572617a646f74742f6e6570616c692d646174652f6261646765)](https://www.codefactor.io/repository/github/surazdott/nepali-date) [![License](https://camo.githubusercontent.com/9602e2863bbec281e15610ea9a229b5190750bd2890bd731ec30cd145ed2b019/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f737572617a646f74742f6e6570616c692d64617465)](https://packagist.org/packages/surazdott/nepali-date)

Introduction
------------

[](#introduction)

Laravel Nepali Date package is a package integrates seamlessly with Laravel, allowing developers to effortlessly manage date conversions according to the Nepali calendar system.

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

[](#installation)

You can install the package via composer. Run the following command in your terminal:

```
composer require surazdott/nepali-date
```

Basic usages
------------

[](#basic-usages)

Laravel will automatically discover this package. Hence, you don't need to add the service provider manually. It supports Nepali dates up to 2100 BS.

Let's look at a simple example using Facade:

```
use Carbon\Carbon;
use NepaliDate\Facades\NepaliDate;

NepaliDate::create(Carbon::now())->toBS(); // 2080-12-20
NepaliDate::create(Carbon::now())->toFormattedBSDate(); // 21 Chaitra 2080, Wednesday
NepaliDate::create(Carbon::now())->toFormattedNepaliDate(); // २१ चैत २०८०, बुधवार
```

Using Carbon Macroable Trait:

```
$user->created_at->toBS(); // 2080-12-20
$user->created_at->toFormattedNepaliDate(); // २१ चैत २०८०, बुधवार
```

Format Specifiers
-----------------

[](#format-specifiers)

Here are some commonly used format specifiers.

- `Y` - Year in four digits (2080)
- `m` - Month in digit (12)
- `F` - Month in full name (January/बैशाख)
- `d` - Day in digit
- `l` - Day in full name (Sunday/आइतबार)

```
NepaliDate::create(Carbon::now())->toNepaliFormat('Y-m-d'); // २०८०-१२-२१
NepaliDate::create(Carbon::now())->toBSformat('d F Y'); // 21 Chaitra 2080
```

Testing
-------

[](#testing)

```
composer test
```

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

[](#contributing)

If you find any issues or have suggestions for improvements, feel free to open an issue or create a pull request. Contributions are welcome!

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](https://opensource.org/license/mit/).

###  Health Score

36

—

LowBetter than 81% of packages

Maintenance51

Moderate activity, may be stable

Popularity21

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~105 days

Total

5

Last Release

344d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7123508bac3964e5bfcca167f292574fa62743edb56e1e0ddde8c3d90af381e1?d=identicon)[surazdott](/maintainers/surazdott)

---

Top Contributors

[![surazdott](https://avatars.githubusercontent.com/u/30065706?v=4)](https://github.com/surazdott "surazdott (3 commits)")

---

Tags

nepali-datelaravel-nepali-datenepali-date-converter

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

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

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

###  Alternatives

[anuzpandey/laravel-nepali-date

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

1615.5k](/packages/anuzpandey-laravel-nepali-date)

PHPackages © 2026

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