PHPackages                             fallahalireza/persian-date-laravel - 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. fallahalireza/persian-date-laravel

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

fallahalireza/persian-date-laravel
==================================

A modern, immutable, and optimized Jalali (Persian/Shamsi) calendar library for PHP and Laravel

v1.0.0(1w ago)00[1 PRs](https://github.com/fallahalireza/persian-date-laravel/pulls)MITPHPPHP ^8.1CI passing

Since May 28Pushed 1w agoCompare

[ Source](https://github.com/fallahalireza/persian-date-laravel)[ Packagist](https://packagist.org/packages/fallahalireza/persian-date-laravel)[ Docs](https://github.com/fallahalireza/persian-date-laravel)[ GitHub Sponsors](https://github.com/:vendor_name)[ RSS](/packages/fallahalireza-persian-date-laravel/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (7)Versions (3)Used By (0)

📅 Persian Date Laravel
======================

[](#-persian-date-laravel)

یک پکیج **مدرن، immutable و بهینه** برای تقویم جلالی (شمسی / فارسی) در PHP و Laravel.

[![PHP](https://camo.githubusercontent.com/6351c44c5acd541a16e8505d9389a2576fb01528ebdbaf6a6b744ac49e401cae/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312b2d626c7565)](https://php.net)[![Laravel](https://camo.githubusercontent.com/ca802a82bf0566a0a9b48f7065bf4a71c8d8e3c0149a7299149d809cdae6ae5b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d3130253246313125324631322d726564)](https://laravel.com)[![License](https://camo.githubusercontent.com/f8df3091bbe1149f398a5369b2c39e896766f9f6efba3477c63e9b4aa940ef14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e)](LICENSE)

---

✨ ویژگی‌های کلیدی
-----------------

[](#-ویژگی‌های-کلیدی)

ویژگیتوضیح**Immutable**هر عملیات یک شیء جدید ایجاد می‌کند**Type-safe**استفاده کامل از `strict_types` و PHP 8.1+**Optimized**الگوریتم سریع تبدیل تاریخ با عملکرد O(1)**Lightweight**فقط وابسته به `nesbot/carbon`**Laravel Ready**Auto-discovery، Facade، Helper و Validation**Carbon Integration**تبدیل مستقیم بین Carbon و Jalali**Persian Locale**پشتیبانی کامل از اعداد و متن فارسی**Testable**تمام متدها pure و قابل تست---

🚀 نصب
=====

[](#-نصب)

```
composer require fallahalireza/persian-date-laravel
```

Laravel به صورت خودکار Service Provider و Facade را register می‌کند.

---

⚡ استفاده سریع
==============

[](#-استفاده-سریع)

```
use Fallahalireza\PersianDate\Jalali;

// تاریخ فعلی
$now = Jalali::now();

$now = jalali(); // helper

// ساخت تاریخ
$date = Jalali::create(1405, 3, 7, 14, 30, 0);

// تبدیل از Carbon
$date = Jalali::fromCarbon(now());

// تبدیل به Carbon
$carbon = $date->toCarbon();
```

---

🔄 Parse تاریخ
=============

[](#-parse-تاریخ)

```
// جلالی
$date = Jalali::parse('1405/03/07');

$date = Jalali::parse('1405-03-07 14:30:00');

// میلادی → جلالی
$date = Jalali::parse('2026-05-28');

// از timestamp
$date = Jalali::fromTimestamp(time());
```

---

🧾 قالب‌بندی تاریخ
=================

[](#-قالب‌بندی-تاریخ)

```
$date = Jalali::create(1405, 3, 7, 14, 30, 0);

$date->toDateString();      // 1405/03/07
$date->toTimeString();      // 14:30:00
$date->toDateTimeString();  // 1405/03/07 14:30:00

$date->toIso8601String();

$date->toFullPersianDate();
// چهارشنبه ۷ خرداد ۱۴۰۵

$date->format('Y/m/d');

$date->formatEnglish('Y/m/d');
```

---

🌍 Locale
========

[](#-locale)

```
Jalali::setLocale('fa'); // پیش‌فرض

Jalali::setLocale('en');
```

---

➕ عملیات تاریخ (Immutable)
==========================

[](#-عملیات-تاریخ-immutable)

```
$date = Jalali::create(1405, 3, 7);

// افزودن
$date->addDays(10);
$date->addMonths(2);
$date->addYears(1);

$date->addWeeks(3);
$date->addHours(5);
$date->addMinutes(30);

// کاهش
$date->subDays(5);
$date->subMonths(1);
$date->subYears(2);
```

---

📌 Boundary Methods
==================

[](#-boundary-methods)

```
$date->startOfDay();
$date->endOfDay();

$date->startOfWeek();
$date->endOfWeek();

$date->startOfMonth();
$date->endOfMonth();

$date->startOfYear();
$date->endOfYear();

$date->startOfQuarter();
$date->endOfQuarter();
```

---

⚖️ مقایسه تاریخ‌ها
==================

[](#️-مقایسه-تاریخ‌ها)

```
$a = Jalali::create(1405, 1, 1);
$b = Jalali::create(1405, 3, 7);

$a->lt($b); // true
$a->gt($b); // false
$a->eq($a); // true

$b->between($a, $b);

$date->isToday();
$date->isFuture();
$date->isPast();

$date->isWeekend();

$date->isLeapYear();
```

---

📏 اختلاف تاریخ‌ها
=================

[](#-اختلاف-تاریخ‌ها)

```
$a = Jalali::create(1405, 1, 1);
$b = Jalali::create(1405, 3, 7);

$a->diffInDays($b);

$a->diffInMonths($b);

$a->diffInYears($b);

$a->diffInHours($b);

$a->diffInSeconds($b);
```

---

🔍 Getter ها
===========

[](#-getter-ها)

```
$date = Jalali::create(1405, 3, 7, 14, 30, 45);

$date->year;
$date->month;
$date->day;

$date->hour;
$date->minute;
$date->second;

$date->dayOfWeek;

$date->dayOfYear;

$date->weekOfYear;

$date->quarter;

$date->timestamp;

$date->timezone;

$date->daysInMonth();
```

---

🧠 Human Diff
============

[](#-human-diff)

```
$date->diffForHumans();

// ۲ روز پیش
// ۳ ماه بعد
```

---

🧩 Carbon Integration
====================

[](#-carbon-integration)

```
$jalali = now()->toJalali();

$carbon = $jalali->toCarbon();
```

---

✅ Validation Rules (Laravel)
============================

[](#-validation-rules-laravel)

```
'birth_date' => ['required', 'jdate'],

'start_date' => [
    'required',
    'jdate',
    'jdate_after:1400/01/01',
],

'end_date' => [
    'required',
    'jdate_before:1410/01/01',
],

'event_date' => [
    'required',
    'jdate_after_or_equal:' . jalali()->toDateString(),
],
```

---

🛠 Helper Function
=================

[](#-helper-function)

```
jalali();

jalali(now());

jalali('1405/03/07');
```

---

🧪 تست
=====

[](#-تست)

```
composer test
```

---

🎨 فرمت کد
=========

[](#-فرمت-کد)

```
composer format
```

---

🔍 آنالیز استاتیک
================

[](#-آنالیز-استاتیک)

```
composer analyse
```

---

📄 مجوز
======

[](#-مجوز)

MIT License © 2026 Alireza Fallah

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance98

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity43

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

Unknown

Total

1

Last Release

12d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/45e3ef868fc228895dad8f49e371418fa012889cbf8891a4eeea51a2f150f1e1?d=identicon)[fallahalireza](/maintainers/fallahalireza)

---

Top Contributors

[![fallahalireza](https://avatars.githubusercontent.com/u/70032867?v=4)](https://github.com/fallahalireza "fallahalireza (1 commits)")

---

Tags

laraveldatecarboncalendarJalalipersianshamsi

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/fallahalireza-persian-date-laravel/health.svg)

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

###  Alternatives

[hekmatinasser/verta

This Package helps developers to work with Jalali Datetime class for Laravel Framework PHP

661541.4k28](/packages/hekmatinasser-verta)[fisharebest/ext-calendar

Implementation of the Arabic (Hijri), French, Gregorian, Jewish, Julian and Persian (Jalali) calendars. Also provides a replacement for the PHP ext/calendar extension.

36497.9k10](/packages/fisharebest-ext-calendar)[p3ym4n/jdate

Date converter from Jalali to Georgian and vice versa. It has Carbon instance inside and it's Laravel friendly.

101.8k2](/packages/p3ym4n-jdate)

PHPackages © 2026

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