PHPackages                             ariaieboy/filament-jalali - 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 &amp; i18n](/categories/localization)
4. /
5. ariaieboy/filament-jalali

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

ariaieboy/filament-jalali
=========================

Add Jalali/Shamsi support for FilamentPHP

3.0.0(5mo ago)4022.9k↓32.6%66MITPHPPHP ~8.2.0|~8.3|~8.4|~8.5CI passing

Since Oct 24Pushed 1w ago1 watchersCompare

[ Source](https://github.com/ariaieboy/filament-jalali)[ Packagist](https://packagist.org/packages/ariaieboy/filament-jalali)[ Docs](https://github.com/ariaieboy/filament-jalali)[ RSS](/packages/ariaieboy-filament-jalali/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (12)Versions (19)Used By (6)

Filament Jalali/Shamsi Support
==============================

[](#filament-jalalishamsi-support)

[![Ariaieboy Filament Jalali](https://camo.githubusercontent.com/5b0ab89844a377175c4e431b8325ed0a514bf11e6c5ecd80c39a519ae1cd3562/68747470733a2f2f707265766965772e647261676f6e2d636f64652e70726f2f417269616965626f792f46696c616d656e742d4a616c616c692e7376673f6272616e643d6c61726176656c)](https://camo.githubusercontent.com/5b0ab89844a377175c4e431b8325ed0a514bf11e6c5ecd80c39a519ae1cd3562/68747470733a2f2f707265766965772e647261676f6e2d636f64652e70726f2f417269616965626f792f46696c616d656e742d4a616c616c692e7376673f6272616e643d6c61726176656c)[![Latest Version on Packagist](https://camo.githubusercontent.com/6ba36655334a72834121dc3bb4076de031c0591caaf790f0b0ecb73b65be85f3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f617269616965626f792f66696c616d656e742d6a616c616c692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ariaieboy/filament-jalali)[![GitHub Actions Workflow Status](https://camo.githubusercontent.com/6acdc64279af673a58bf352ac71f73fd5bf54b611d606b830c88fb05ef422225/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f617269616965626f792f66696c616d656e742d6a616c616c692f7068702d63732d66697865722e796d6c3f6c6162656c3d7374796c696e67)](https://camo.githubusercontent.com/6acdc64279af673a58bf352ac71f73fd5bf54b611d606b830c88fb05ef422225/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f617269616965626f792f66696c616d656e742d6a616c616c692f7068702d63732d66697865722e796d6c3f6c6162656c3d7374796c696e67)[![Total Downloads](https://camo.githubusercontent.com/09038cca068e6e94ae23bf6b221137a5eeb7062140295e0f216650c09eab67b9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f617269616965626f792f66696c616d656e742d6a616c616c692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ariaieboy/filament-jalali)

> This package adds Jalali/Shamsi support to filament v5 for filament v4 check branch [v2](https://github.com/ariaieboy/filament-jalali/tree/v2) and for filament v3 check branch [v1](https://github.com/ariaieboy/filament-jalali/tree/v1).

We have Jalali/Shamsi support for `DatePicker`,`DateTimePicker`,`TextColumn`, `TextEntry` and `DateConstraint`.

It's a replacement for [ariaieboy/filament-jalali-datetime](https://github.com/ariaieboy/filament-jalali-datetime) and [ariaieboy/filament-jalali-datetimepicker](https://github.com/ariaieboy/filament-jalali-datetimepicker). For Upgrade guide check [here](README.md#upgrade)

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

[](#installation)

You can install the package via composer:

```
composer require ariaieboy/filament-jalali
```

Usage
-----

[](#usage)

```
use Filament\Forms\Components\DatePicker;
use Filament\Forms\Components\DateTimePicker;

DatePicker::make('birth_date')->jalali();
DateTimePicker::make('birth_date')->jalali(weekdaysShort: true);
DateTimePicker::make('birth_date')->jalali(weekdaysShort: true)->hasToday(); // add a today button that when use press on it the date will be set to today
```

For more information check the default [DateTimePicker Docs](https://filamentphp.com/docs/4.x/forms/fields#date-time-picker)

```
use Filament\Tables\Columns\TextColumn;

TextColumn::make('created_at')->jalaliDate();
TextColumn::make('created_at')->jalaliDateTime();
```

For more information check the default [TextColumn Docs](https://filamentphp.com/docs/4.x/tables/columns/text)

```
use Filament\Infolists\Components\TextEntry;

TextEntry::make('created_at')->jalaliDate();
TextEntry::make('created_at')->jalaliDateTime();
TextEntry::make('created_at')->since()->jalaliDateTooltip();
TextEntry::make('created_at')->since()->jalaliDateTimeTooltip();
```

For more information check the default [TextEntry Docs](https://filamentphp.com/docs/4.x/infolists/entries/text)

```
use Filament\Tables\Filters\QueryBuilder\Constraints\DateConstraint;
use Ariaieboy\FilamentJalali\DateConstraint\Operators\IsJalaliAfterOperator;
use Ariaieboy\FilamentJalali\DateConstraint\Operators\IsJalaliBeforeOperator;
use Ariaieboy\FilamentJalali\DateConstraint\Operators\IsJalaliDateOperator;
use Ariaieboy\FilamentJalali\DateConstraint\Operators\IsJalaliYearOperator;

DateConstraint::make('created_at')->jalali();
//Or you can use any operations that you like
DateConstraint::make('created_at')->operators([
        IsJalaliAfterOperator::class,
        IsJalaliBeforeOperator::class,
        IsJalaliDateOperator::class,
        IsJalaliYearOperator::class
]);
```

For more information check the default [DateConstraint Docs](https://filamentphp.com/docs/4.x/tables/filters/query-builder#date-constraints)

> We don't support `IsJalaliMonthOperator` since there is not and efficient way to query georgian month according to the jalali/shamsi month.

> Fill free to open a PR that adds `IsJalaliMonthOperator` if you have an algorithm to convert jalali/shamsi month to georgian month.

Localization
------------

[](#localization)

We support localization for Persian (Farsi), English, Pashto, Dari out of the box. To enable it, you need to set your application's locale to `fa`,`en`,`fa_AF`,`ps` in the `config/app.php` file:

```
'locale' => 'fa' // or 'en' for english, 'fa_AF' dari, 'ps' for pashto
```

You can publish the localization files to customize them:

```
php artisan vendor:publish --tag="filament-jalali-translations"
```

Changelog
---------

[](#changelog)

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

Upgrade
-------

[](#upgrade)

### from `v2`

[](#from-v2)

If you are using the V2 of the `ariaieboy/filament-jalali` you need to change the package version in your composer.json to

```
{
    "require": {
        "ariaieboy/filament-jalali": "^3.0"
    }
}
```

Then run `composer update` command.

### from `v1`

[](#from-v1)

If you are using the V1 of the `ariaieboy/filament-jalali` you need to change the package version in your composer.json to

```
{
    "require": {
        "ariaieboy/filament-jalali": "^2.0"
    }
}
```

Then run `composer update` command.

### from `ariaieboy/filament-jalali-datetimepicker`

[](#from-ariaieboyfilament-jalali-datetimepicker)

If you are using the V3 of the jalali-datetimepicker you don't need to do anything just replace `ariaieboy/filament-jalali-datetimepicker` with `ariaieboy/filament-jalali`

### from `ariaieboy/filament-jalali-datetime`

[](#from-ariaieboyfilament-jalali-datetime)

If you use the `jalaliDate()` and `jalaliDateTime()` on the `TextColumn` you can upgrade without any problem.

But if you use the `JalaliDateTimeColumn` you need to change it to `TextColumn` and convert `dateTime() to jalaliDateTime()` and `date() to jalaliDate()`

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

[](#contributing)

Please see [CONTRIBUTING](https://github.com/spatie/.github/blob/main/CONTRIBUTING.md) for details.

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

[](#security-vulnerabilities)

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

Credits
-------

[](#credits)

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

License
-------

[](#license)

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

###  Health Score

56

—

FairBetter than 97% of packages

Maintenance86

Actively maintained with recent releases

Popularity40

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 92% 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 ~27 days

Recently: every ~14 days

Total

18

Last Release

156d ago

Major Versions

1.1.1 → 2.0.02025-07-09

v1.x-dev → 2.0.12025-07-16

v2.x-dev → 3.0.02026-01-28

PHP version history (2 changes)1.0.0PHP ~8.2.0|~8.3|~8.4

2.0.3PHP ~8.2.0|~8.3|~8.4|~8.5

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/15873972?v=4)[AriaieBOY](/maintainers/ariaieboy)[@ariaieboy](https://github.com/ariaieboy)

---

Top Contributors

[![ariaieboy](https://avatars.githubusercontent.com/u/15873972?v=4)](https://github.com/ariaieboy "ariaieboy (138 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (7 commits)")[![yasinnoori](https://avatars.githubusercontent.com/u/20409577?v=4)](https://github.com/yasinnoori "yasinnoori (3 commits)")[![alisalehi1380](https://avatars.githubusercontent.com/u/111766206?v=4)](https://github.com/alisalehi1380 "alisalehi1380 (1 commits)")[![SaeidSharafi](https://avatars.githubusercontent.com/u/6916349?v=4)](https://github.com/SaeidSharafi "SaeidSharafi (1 commits)")

---

Tags

laravelariaieboyfilament-jalali-datetimepickerfilament-jalali-supportfilament-shamsi-calendarfilament-shamsi-support

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/ariaieboy-filament-jalali/health.svg)

```
[![Health](https://phpackages.com/badges/ariaieboy-filament-jalali/health.svg)](https://phpackages.com/packages/ariaieboy-filament-jalali)
```

###  Alternatives

[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[bezhansalleh/filament-language-switch

Zero config Language Switch(Changer/Localizer) plugin for filamentphp admin

3581.3M28](/packages/bezhansalleh-filament-language-switch)[stephenjude/filament-feature-flags

Filament implementation of feature flags and segmentation with Laravel Pennant.

122177.8k1](/packages/stephenjude-filament-feature-flags)[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17760.2k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-debugger

About

104162.2k2](/packages/stephenjude-filament-debugger)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

84215.9k9](/packages/stephenjude-filament-two-factor-authentication)

PHPackages © 2026

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