PHPackages                             yashar-rashedi/jalali-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. yashar-rashedi/jalali-date

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

yashar-rashedi/jalali-date
==========================

Jalali calendar conversion to gregorian and vise versa.

0841PHP

Since Jan 29Pushed 1y ago1 watchersCompare

[ Source](https://github.com/yasharrashedi/jalali-date)[ Packagist](https://packagist.org/packages/yashar-rashedi/jalali-date)[ RSS](/packages/yashar-rashedi-jalali-date/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

HOW-TO GUIDE
============

[](#how-to-guide)

### Convert Gregorian calendar date to Jalali

[](#convert-gregorian-calendar-date-to-jalali)

```
$date = new Jalali();
echo $date->setGregorianDate(new \DateTime())->getJalali()->format('Y/m/d');

```

As you may have noticed, you can use [PHP's standard date format characters](http://php.net/manual/en/function.date.php) to format your Jalali date. Isn't that cool?

### Convert Jalali calendar date to Gregorian

[](#convert-jalali-calendar-date-to-gregorian)

```
$date = new Jalali(1392, 6, 6);
echo $date->getGregorian()->format('Y/m/d');

```

### Formatting the converted date

[](#formatting-the-converted-date)

Let's say you want to output the Jalali converted date to something like "پنج شنبه، ۸ شهریور ۱۳۹۲" You can achieve this by

```
$date = new Jalali();
echo $date->setGregorianDate(new \DateTime())->getJalali()->format('w, d F Y');

```

This looks pretty much like the above code. All I have done is that I have provided a different format string `w, d F Y`

### Adding units of date/time to the Jalali calendar date

[](#adding-units-of-datetime-to-the-jalali-calendar-date)

To add a number of years/months/days/hours/minutes/seconds to the converted Jalali date you can use the `add()` method.

This method accepts two arguments. The first one is the number of units to add to the date and the second one is the date/time designator character.

Let's say you want to add 7 days to the current date.

```
$date = new Jalali(1392, 6, 6);
echo $date->add(7, 'D')->format('Y/m/d');

```

You could also do it like this:

```
$date = new Jalali(1392, 6, 6);
echo $date->add(1, 'W')->format('Y/m/d');

```

Again if you've noticed, [PHP's standard DateInterval characters](http://www.php.net/manual/en/dateinterval.construct.php) are used to add units of date/time to the Jalali date.

You can also use *negative values* for the unit being added to the Jalali date to subtract the amount of date/time from the Jalali date if you need to navigate backward in time.

### Convert TIMESTAMP to a Jalali calendar date

[](#convert-timestamp-to-a-jalali-calendar-date)

```
$date = new Jalali();
echo $date->setTimestamp(time())->getJalali()->format('Y/m/d');

```

It was that simple. All you need to do to convert a timestamp.

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity16

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/5fe5511845db336fd311077cc519cee2953c5e31d02f9a51a67b0bcdc224f364?d=identicon)[yasharrashedi](/maintainers/yasharrashedi)

---

Top Contributors

[![yashar2004](https://avatars.githubusercontent.com/u/51485450?v=4)](https://github.com/yashar2004 "yashar2004 (3 commits)")

### Embed Badge

![Health badge](/badges/yashar-rashedi-jalali-date/health.svg)

```
[![Health](https://phpackages.com/badges/yashar-rashedi-jalali-date/health.svg)](https://phpackages.com/packages/yashar-rashedi-jalali-date)
```

###  Alternatives

[soup/paginator

Paginator is a simple class that allows you to create pagination. It doesn't require any database connection. It is compatible with Twitter's Bootstrap Framework, by using the CSS class pagination that is also attached.

351.5k](/packages/soup-paginator)[components/jquery-htmlclean

HTML Clean plug-in for jQuery

183.1k1](/packages/components-jquery-htmlclean)

PHPackages © 2026

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