PHPackages                             mokhosh/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. [Utility & Helpers](/categories/utility)
4. /
5. mokhosh/filament-jalali

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

mokhosh/filament-jalali
=======================

Add Jalali datetime to your filament tables

v5.1.0(7mo ago)6744.4k↓43.5%12[3 PRs](https://github.com/mokhosh/filament-jalali/pulls)2MITJavaScriptPHP ^8.2CI passing

Since Jul 22Pushed 6mo ago1 watchersCompare

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

READMEChangelog (10)Dependencies (10)Versions (37)Used By (2)

Add "Jalali calendar" columns and pickers to Filament
=====================================================

[](#add-jalali-calendar-columns-and-pickers-to-filament)

[![Latest Version on Packagist](https://camo.githubusercontent.com/217ba690aabc66042ffb1c0573b1d5b1a09763b9588670f987fc431ac468fd0c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6f6b686f73682f66696c616d656e742d6a616c616c692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mokhosh/filament-jalali)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/3b8aab2946fdebf53357bd7d80beb3e654c838127757769532778ee13e4c271d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d6f6b686f73682f66696c616d656e742d6a616c616c692f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/mokhosh/filament-jalali/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/ec8f21e1be33d882d898c0d1bc48638aee8d27e644656c30d3cd52537921ab31/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6f6b686f73682f66696c616d656e742d6a616c616c692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/mokhosh/filament-jalali)

[![Jalali datetime picker form component and table text column](https://raw.githubusercontent.com/mokhosh/filament-jalali/main/art/readme.jpg)](https://raw.githubusercontent.com/mokhosh/filament-jalali/main/art/readme.jpg)

No fuss package to add Jalali Date and DateTime columns to your table, and a beautiful Jalali Date and DateTime picker to your forms. No new column type, just keep using your good old `TextColumn`s! No new form components, just keep using your beautiful `DatePicker`s and `DateTimePicker`s!

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

[](#installation)

You can install the package via composer:

```
composer require mokhosh/filament-jalali
```

Usage
-----

[](#usage)

To add Jalali date and date-time columns to your tables, just add `jalaliDate` and `jalaliDateTime` to the filament `TextColumn`s instead of `date` or `dateTime`.

```
// Yes! Just use Filament's original TextColumns!
use Filament\Tables;

Tables\Columns\TextColumn::make('created_at')
    ->jalaliDate(),
Tables\Columns\TextColumn::make('updated_at')
    ->jalaliDateTime(),
```

To add Jalali date and date-time columns to your infolists, just add `jalaliDate` and `jalaliDateTime` to the filament `TextEntry`s instead of `date` or `dateTime`.

```
use Filament\Infolists\Components;

Components\TextEntry::make('created_at')
    ->jalaliDate(),
Components\TextEntry::make('updated_at')
    ->jalaliDateTime(),
```

To add Jalali date and date-time pickers to your forms, just add `jalali`to your `DatePicker` and `DateTimePicker`.

```
// Yes! Just use Filament's original DatePickers and DateTimePickers!
use Filament\Forms;

Forms\Components\DatePicker::make('moderated_at')
    ->jalali(),
Forms\Components\DateTimePicker::make('published_at')
    ->jalali(),
```

Ignoring Jalali Conversion
--------------------------

[](#ignoring-jalali-conversion)

If you want to ignore jalali conversion you can use the `when` and `unless` methods:

```
use Filament\Tables;
use Filament\Infolists\Components;
use Filament\Forms;
use Illuminate\Support\Facades\App;

Tables\Columns\TextColumn::make('created_at')
    ->date()
    ->when(App::isLocale('fa'), fn (TextColumn $column) => $column->jalaliDate()),

Components\TextEntry::make('updated_at')
    ->dateTime()
    ->unless(App::isLocale('en'), fn (TextColumn $column) => $column->jalaliDateTime()),

Forms\Components\DatePicker::make('birthday')
    ->when(App::isLocale('fa'), fn (TextColumn $column) => $column->jalali()),
```

Configuring the Format Globally
-------------------------------

[](#configuring-the-format-globally)

You can set the default date formats for tables, infolists and date/time pickers anywhere you want, likely in a service provider:

```
public function boot(): void
{
    Table::$defaultDateDisplayFormat = 'Y/m/d';
    Table::$defaultDateTimeDisplayFormat = 'Y/m/d H:i:s';

    Infolist::$defaultDateDisplayFormat = 'Y/m/d';
    Infolist::$defaultDateTimeDisplayFormat = 'Y/m/d H:i:s';

    DateTimePicker::$defaultDateDisplayFormat = 'Y/m/d';
    DateTimePicker::$defaultDateTimeDisplayFormat = 'Y/m/d H:i';
    DateTimePicker::$defaultDateTimeWithSecondsDisplayFormat = 'Y/m/d H:i:s';
}
```

Some common formats you might want to use:

`j F Y` ۱۵ مهر ۱۳۶۸

`Y/m/d` ۱۳۶۸/۰۷/۱۵

`l j F` شنبه ۱۵ مهر

Filament 4 Custom Theme Integration
-----------------------------------

[](#filament-4-custom-theme-integration)

Filament 4 uses a new theme system. To include filament-jalali’s styles in your Filament admin panel, do the following:

### 1. Create a custom Filament theme

[](#1-create-a-custom-filament-theme)

Run the artisan command:

```
php artisan make:filament-theme
```

Follow the instructions to create your custom theme (e.g., `FilamentTheme`).

---

### 2. Import filament-jalali styles in your theme’s CSS file

[](#2-import-filament-jalali-styles-in-your-themes-css-file)

Add this line to your generated theme CSS file (usually something like `resources/css/filament/admin/theme.css`):

```
@source '../../../../vendor/mokhosh/filament-jalali/resources/**/*';
```

This imports all CSS/SCSS from the filament-jalali package.

---

### 3. Add the theme CSS file to your Vite input in vite.config.js

[](#3-add-the-theme-css-file-to-your-vite-input-in-viteconfigjs)

Edit your `vite.config.js`:

```
export default defineConfig({
    // ...
    build: {
        rollupOptions: {
            input: [
                // other inputs ...
                'resources/css/filament/admin/theme.css',
            ],
        },
    },
    // ...
});
```

---

### 4. Register the compiled theme CSS file in your Filament panel provider

[](#4-register-the-compiled-theme-css-file-in-your-filament-panel-provider)

In your panel service provider (e.g., `App\Providers\FilamentServiceProvider`), add:

```
use Filament\Panel;

public function panel(Panel $panel): Panel
{
    return $panel
        // other panel config ...
        ->viteTheme('resources/css/filament/admin/theme.css');
}
```

---

### 5. Compile your assets with Vite

[](#5-compile-your-assets-with-vite)

Run:

```
npm run build
```

or for development:

```
npm run dev
```

Credits
-------

[](#credits)

- [Mo Khosh](https://github.com/mokhosh)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

53

—

FairBetter than 97% of packages

Maintenance66

Regular maintenance activity

Popularity42

Moderate usage in the ecosystem

Community22

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 93.1% 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 ~23 days

Recently: every ~48 days

Total

36

Last Release

220d ago

Major Versions

v1.2 → v2.02023-07-24

v2.0 → v3.02023-08-03

v2.3.8 → v3.2.82024-03-06

v3.5.0 → v4.0.02024-09-08

v4.10.0 → v5.0.02025-09-06

PHP version history (2 changes)v0.1PHP ^8.1

v5.0.0PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/939919859a4e4f8e56b5771bc355135f44d98d8a3926baa6ce4358d2dc090edf?d=identicon)[mokhosh](/maintainers/mokhosh)

---

Top Contributors

[![mokhosh](https://avatars.githubusercontent.com/u/6499685?v=4)](https://github.com/mokhosh "mokhosh (108 commits)")[![MeghdadFadaee](https://avatars.githubusercontent.com/u/61308304?v=4)](https://github.com/MeghdadFadaee "MeghdadFadaee (3 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")[![amidesfahani](https://avatars.githubusercontent.com/u/61671721?v=4)](https://github.com/amidesfahani "amidesfahani (1 commits)")[![Milad-Sarli](https://avatars.githubusercontent.com/u/150502402?v=4)](https://github.com/Milad-Sarli "Milad-Sarli (1 commits)")[![Hebrahimzadeh](https://avatars.githubusercontent.com/u/38420287?v=4)](https://github.com/Hebrahimzadeh "Hebrahimzadeh (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

laravelmokhoshfilament-jalali

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[guava/calendar

Adds support for vkurko/calendar to Filament PHP.

298241.0k3](/packages/guava-calendar)[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)[mokhosh/filament-kanban

Add kanban boards to your Filament pages

453180.4k1](/packages/mokhosh-filament-kanban)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[creagia/filament-code-field

A Filamentphp input field to edit or view code data.

58289.3k3](/packages/creagia-filament-code-field)[swisnl/filament-backgrounds

Beautiful backgrounds for Filament auth pages

54149.2k6](/packages/swisnl-filament-backgrounds)

PHPackages © 2026

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