PHPackages                             dipesh/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. [Utility & Helpers](/categories/utility)
4. /
5. dipesh/nepali-date

ActiveLibrary[Utility & Helpers](/categories/utility)

dipesh/nepali-date
==================

The Nepali Date package is designed for working with the Nepali calendar. It provides functionality for converting dates between the English (AD) and Nepali (BS) calendars, along with a wide range of methods for handling and manipulating Nepali dates. This comprehensive tool facilitates seamless integration and operations within the Nepali calendar system.

v2.1.1(1y ago)4323↓75%1[4 issues](https://github.com/pokhreldipesh/nepalidate/issues)1MITPHPPHP >=8.0

Since Jan 5Pushed 1y ago1 watchersCompare

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

READMEChangelog (6)Dependencies (2)Versions (17)Used By (1)

Nepali Date
===========

[](#nepali-date)

The Nepali Date package is designed for working with the Nepali calendar. It provides functionality for converting dates between the English (AD) and Nepali (BS) calendars, along with a wide range of methods for handling and manipulating Nepali dates. This comprehensive tool facilitates seamless integration and operations within the Nepali calendar system.

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

[](#installation)

To install the package, use Composer:

```
composer require dipesh/nepali-date

```

### Uses

[](#uses)

Creating Instances

```
use Dipesh\NepaliDate\NepaliDate;

$date = new NepaliDate(language: 'np or en'); // Creates current date instance with provided language.

//or
$date = $date->setLang('np') or $date->setLang(new \Dipesh\NepaliDate\lang\Nepali()) // Creates immutable instance

//or
$date = new NepaliDate("2050-8-10") // Creates date instance with default language configuration
//You are free to use either of these formats, e.g., yyyy-mm-dd or yyyy/mm/dd."
//or
$date = NepaliDate::make("2070-8-20"); // Creates date instance with default language configuration

//or
$date = NepaliDate::now(); // Creates current date instance

// Work with global instance
$date->create($date); // Creates an immutable date instance while retaining the previous configuration settings.
```

### Date Conversion

[](#date-conversion)

```
$date->toAd(); // creates php Date instance
//or
$date = NepaliDate::fromADDate("1990-9-10");
```

### Date Component Retrieval Based on the Language Configuration

[](#date-component-retrieval-based-on-the-language-configuration)

```
$date->year();   // Retrieves the year
$date->month($format);  // Retrieves the formatted month
$date->day();    // Retrieves the day
$date->weekDay($format); // Retrieves the formatted week day
```

### Date Manipulation and Comparison Methods

[](#date-manipulation-and-comparison-methods)

```
$date->addDays($days);

$date->subDays($days);

$date->isEqual('2048/10/5'); // return true or false

$date->isGreaterThan('2048/10/5');

$date->isLessThan('2048/10/5');
```

### Formatting

[](#formatting)

Supported format characters: Y, m, M, F, d, w, D, l, g

Format CharacterDescriptionExample Output`Y`Year (4-digit format)`2078``m`Month (Numeric, zero-padded, 01-12)`01` for Baisakh, `12` for Chait`M`Month (Short textual representation)`Bai` for Baisakh, `Dec` for Chai`F`Month (Full textual representation)`Baisakh`, `Jeth``d`Day of the month (Numeric, zero-padded, 01-31)`01` for the 1st, `31` for the 31st`w`Day of the week (Numeric, 1-7)`1` for Aaitabar, `7` for Sanibar`D`Day of the week (Short textual representation)`Aaita` for Aaitabar, `Budh` for Budhabar`l`Day of the week (Full textual representation)`Aaitabar`, `Sombar``g`This is not for english(AD) format`Gate` or `गते````
$date->format('Y-m-d'); // 2050-10-8

$date->format('Y F d g l'); // 2050 Magh 8 Gate Sukrabar

$date->format("Y-m-d, M d g l") // २०५०-१०-२८, माघ २८ गते बिहिबार"

//or
$date->format("Y-m-d, M d g l", 'np')
```

Recommended Package for Full [Calendar](https://github.com/pokhreldipesh/calendar) System
-----------------------------------------------------------------------------------------

[](#recommended-package-for-full-calendar-system)

For developers looking to create a comprehensive [Calendar](https://github.com/pokhreldipesh/calendar) system, we recommend the **dipesh/calendar** package. This package provides an easy-to-use interface for managing a full Nepali calendar, allowing you to seamlessly add events, navigate through months and years, and much more.

To install the package, run:

```
composer require dipesh/calendar
```

---

Extending and Customizing the Nepali Date Package
-------------------------------------------------

[](#extending-and-customizing-the-nepali-date-package)

This package is designed for great extensibility, allowing you to customize key components to fit your specific needs. The package is built around three main concepts:

1. **DateProcessor**: Handles all date-related calculations and logic.
2. **Language**: Manages language-specific aspects, such as number formatting and month names.
3. **Formatter**: Controls how dates are formatted and displayed.

You can extend or replace these components with your own implementations, enabling you to modify the core logic without touching the existing codebase. Below are examples of how to achieve this customization:

### Example: Extending the Nepali Date Class

[](#example-extending-the-nepali-date-class)

```
// Extending the main NepaliDate class
class CustomDate extends \Dipesh\NepaliDate\NepaliDate
{
    // Your new feature implementation goes here

    // Use a custom date processor for all date-related logic
    public function getDateProcessor()
    {
        return new CustomDateProcessor();
    }

    // Use a custom formatter for all date formatting
    public function getFormatter()
    {
        return new CustomFormatter();
    }
}
```

### Example: Creating a Custom DateProcessor

[](#example-creating-a-custom-dateprocessor)

```
// Implementing a custom DateProcessor
class CustomDateProcessor implements \Dipesh\NepaliDate\Contracts\DateProcessor
{
    public function getDays(int $year, int $month, int $day): int
    {
        // Your custom logic for calculating days
    }

    public function getDateFromDays(int $totalDays): string
    {
        // Your custom logic for calculating a date from total days
    }

    public function getWeekDayFromDays(int $days): int
    {
        // Your custom logic for determining the weekday from days
    }
}
```

### Example: Creating a Custom Formatter

[](#example-creating-a-custom-formatter)

```
// Implementing a custom Formatter
class CustomFormatter implements \Dipesh\NepaliDate\Contracts\Formatter
{
    public function setUp(Date $date): static
    {
        // Setup logic with the date
    }

    public function format(string $format): string
    {
        // Your custom logic for formatting the date
    }

    public function formatNumber(int $number): string
    {
        // Your custom logic for formatting numbers
    }

    public function formatMonth(string $format = 'm'): mixed
    {
        // Your custom logic for formatting months
    }

    public function formatWeekDay(string $format = 'w'): mixed
    {
        // Your custom logic for formatting weekdays
    }
}
```

### Example: Creating a Custom Language

[](#example-creating-a-custom-language)

```
// Implementing a custom language
class CustomLanguage implements \Dipesh\NepaliDate\Contracts\Language
{
    public function getGate(): string
    {
        // Your custom language specific gate especially useful for nepali language and you might not need this
        // Eg: return "";
    }

    public function getDigit(int $digit):int|string
    {
        // Your custom language specific digit
        // Eg: return 1;
    }

    public function getWeek(int $week):array
    {
        // Your custom language specific week day
        // Eg: return ['l' => 'Sunday', 'D' => 'Sun'];
    }

    public function getMonth(int $month):array
    {
        // Your custom language specific month
        // Eg: return ['F' => 'January', 'M' => 'Jan'];
    }
}
```

---

License
-------

[](#license)

Nepali Date is open-sourced package licensed under the [MIT license](https://opensource.org/licenses/MIT).\*\*\*\*

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity18

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity59

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 ~40 days

Recently: every ~4 days

Total

16

Last Release

630d ago

Major Versions

v1.2.3 → v2.0.02024-08-08

PHP version history (2 changes)v1.0.0PHP >=7.4

v2.0.0PHP >=8.0

### Community

Maintainers

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

---

Top Contributors

[![pokhreldipesh](https://avatars.githubusercontent.com/u/118336432?v=4)](https://github.com/pokhreldipesh "pokhreldipesh (45 commits)")

---

Tags

datenepali-datenepali-date-converternepalidate-converter

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[rlanvin/php-rrule

Lightweight and fast recurrence rules for PHP (RFC 5545)

69810.6M39](/packages/rlanvin-php-rrule)[knplabs/knp-time-bundle

Making your dates and durations look sensible and descriptive

6308.9M39](/packages/knplabs-knp-time-bundle)[aeon-php/calendar

PHP type safe, immutable calendar library

2079.7M16](/packages/aeon-php-calendar)[kartik-v/yii2-widget-datepicker

Enhanced Yii2 wrapper for the bootstrap datepicker plugin (sub repo split from yii2-widgets).

1097.0M60](/packages/kartik-v-yii2-widget-datepicker)

PHPackages © 2026

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