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(3mo ago)3819.2k↓44.9%6[1 issues](https://github.com/ariaieboy/filament-jalali/issues)5MITPHPPHP ~8.2.0|~8.3|~8.4|~8.5CI passing

Since Oct 24Pushed 3mo 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 1mo ago

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

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

54

—

FairBetter than 97% of packages

Maintenance79

Regular maintenance activity

Popularity38

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

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

110d 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://www.gravatar.com/avatar/e89700c75410a20d43857b37107b59d3dffe75166434efa9bed47668723fcdb9?d=identicon)[ariaieboy](/maintainers/ariaieboy)

---

Top Contributors

[![ariaieboy](https://avatars.githubusercontent.com/u/15873972?v=4)](https://github.com/ariaieboy "ariaieboy (136 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 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

[bezhansalleh/filament-language-switch

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

3431.0M16](/packages/bezhansalleh-filament-language-switch)[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)[outerweb/filament-translatable-fields

Filament integration for spatie/laravel-translatable

3582.9k8](/packages/outerweb-filament-translatable-fields)[abdulmajeed-jamaan/filament-translatable-tabs

Simplifying managing json based translation columns using tabs

3755.2k1](/packages/abdulmajeed-jamaan-filament-translatable-tabs)[elegantly/laravel-translator

All on one translations management for Laravel

6216.9k](/packages/elegantly-laravel-translator)[pixelpeter/filament-language-tabs

Group multilingual fields into tabs

128.0k](/packages/pixelpeter-filament-language-tabs)

PHPackages © 2026

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