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

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

mtm/persian-date
================

Persian Date for PHP ( Object Oriented API )

1.1.2(9y ago)425011MITPHP

Since Aug 14Pushed 9y ago1 watchersCompare

[ Source](https://github.com/motammem/persian_date)[ Packagist](https://packagist.org/packages/mtm/persian-date)[ RSS](/packages/mtm-persian-date/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (7)Used By (1)

Persian Date (Object Oriented API)
==================================

[](#persian-date-object-oriented-api)

---

[![Stable release](https://camo.githubusercontent.com/77f7088db2346c0a3dfab98ce562d6ee51acd7b59f8f9565fb15da71b4bf3087/68747470733a2f2f706f7365722e707567782e6f72672f6d746d2f7065727369616e2d646174652f76657273696f6e2e737667)](https://packagist.org/packages/mtm/persian-date)[![Total Downloads](https://camo.githubusercontent.com/ae744f9a76929196d523eccd0bea77fea9be1b75f11805c5cc99c3afeed1ecf3/68747470733a2f2f706f7365722e707567782e6f72672f6d746d2f7065727369616e2d646174652f646f776e6c6f616473)](https://packagist.org/packages/mtm/persian-date)[![License](https://camo.githubusercontent.com/73a415a071771b18b46325824f268e9910df86725ec3dd2c6933f8f692cceced/68747470733a2f2f706f7365722e707567782e6f72672f6d746d2f7065727369616e2d646174652f6c6963656e7365)](https://packagist.org/packages/mtm/persian-date)[![Build Status](https://camo.githubusercontent.com/fb65f1fad78ad55ee1f017c0f24e33424d95e4fafbadc330ec0c6a9f98600b46/68747470733a2f2f7472617669732d63692e6f72672f6d6f74616d6d656d2f7065727369616e5f646174652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/motammem/persian_date)

This project provides an easy to use Object Oriented API to work with persian date and time.

Provided `PersianDate` class extends Standard PHP `DateTime` class and has it's all capabilities.

\###Installation: Open your terminal and enter:

```
composer require mtm/persian-date
```

\###Usage:

When you want build a PersianDate instance:

```
$persianDateTime = new Mtm\PersianDate\PersianDate();
```

When you want build a PersianDate instance from exact date:

```
$persianDateTime = Mtm\PersianDate\PersianDateFactory::buildFromExactDate(null, null, null, 9, 19 ,1370);
```

When you want to convert PHP Standard Datetime to PersianDate instance from standard PHP Standard DateTime object:

```
$standardDateTime = new \DateTime();
$persianDateTime = Mtm\PersianDate\PersianDateFactory::buildFromOriginalDateTime($standardDateTime);
```

When you want to convert PersianDate instance to PHP Standard DateTime object:

```
$standardDateTime = $persianDateTime->getOriginalDateTime();
```

When you want to set date on PersianDate instance

```
$persian_year = 1370;
$persian_month = 9;
$persian_day = 19;

$persianDateTime->setDate($persian_year, $persian_month, $persian_day);
```

### Formats

[](#formats)

And finally when you want to print in various formats:

```
$persianDateTime->format("Y-m-d"); // prints: 1370-9-19

$persianDateTime->format("f y"); // prints: پاییز 94
```

(?)مثال ۲مثال ۱دامنهکاربرد های متد format()کاراکتر----کاراکترها با حروف کوچککوچک+ب.ظق.ظق.ظ | ب.ظاوقات روز - به صورت خلاصهa!۴۱۱ - ۴شماره ی فصل (ربع) از سالb+۱۳۸۹/۱۱/۲۲ ،۰۹:۴۶:۳۱ +۰۳:۳۰۱۳۹۰/۴/۴ ،۱۳:۰۸:۲۶ +۰۴:۳۰: طبق نمونهY/n/j ,H:i:s P :(ltr) ۱ قالب مرکّبc+۲۳۹۰۱ - ۳۱شماره ی روز از ماه - ۲ رقمیd+Asia/TehranGreenwichمناطق زمانیمنطقه ی زمانی تنظیم شدهe!زمستانتابستانبهار تا زمستاننام فصل با حروف فارسیf+۱۲۷۱ - ۱۲ساعت در روز -۱۲ساعته -۱یا۲رقمیg+۱۲۰۷۰۱ - ۱۲ساعت در روز - ۱۲ ساعته - ۲رقمیh+۲۱۱۷۰۰ - ۵۹دقیقه در ساعت - ۲ رقمیi+۲۳۲۱ - ۳۱شماره ی روز از ماه - ۱یا۲ رقمیj!۱۶۷۶.۲۰ - ۱۰۰(\*\*.?) در صد باقیمانده از سالk+چهار شنبهشنبهشنبه تا جمعهنام روز در هفته - کاملl+۱۰۰۳۰۱ - ۱۲شماره ی ماه از سال - ۲رقمیm+۱۰۳۱ - ۱۲شماره ی ماه از سال - ۱یا۲رقمیn+۱۳۸۹۱۳۹۱شماره ی سالسال هفته ای (به عدد) چهار رقمیo!دلوجوزاحمل تا حوتنام باستانی برج هاp!پلنگگاوموش تا خوکنام حیوانی سال هاq+۰۹:۴۶:۳۱ +۰۳۳۰ جمعه، ۲۲ بهمن ۱۳۸۹۱۳:۰۸:۲۶ +۰۴۳۰ شنبه، ۴ تیر ۱۳۹۰: طبق نمونهH:i:s O Y F j ,l :(ltr) ۲ قالب مرکّبr+۱۷۰۹۰۰ - ۵۹شماره ی ثانیه در دقیقه - ۲ رقمیs+۳۰۳۱۳۱ | ۳۰ | ۲۹تعداد روزهای (همان) ماهt+۷۳۹۰۳۱۰۰۰۰۰۰: طبق نمونهمیکرو ثانیه - ۶ رقمیu!هشتاد و نهنود و یکاز ‍ تا نود و نهسال به حروف - خلاصه ی دو رقمیv+۳۰۰ - ۶شنبه=۰ ،عدد روز در هفته (IR)w+۸۹۹۱۰۰ - ۹۹سال (به عدد) دو رقمیy+۳۰۴۴۱۰ - (۳۶۴|۳۶۵)تعداد روز (کامل) گذشته از سالz----کاراکترها با حروف بزرگبزرگ+بعد از ظهرقبل از ظهر: طبق نمونهاوقات روز \_ کاملA+۷۱۰۰۹۸۰۰۰ - ۹۹۹GMTزمان اینترنتی،۱.۴۴ دق‍ از۲۳:۰۰B!۱۵۱۴...|۱۵|۱۴|...شماره ی قرن هجری شمسیC+چشش تا جحرف اوّل نام روز هفته، ش=شنبهD+دیخردادفروردین تا اسفندنام ماه از سال - کاملF+۱۹۷۰ - ۲۳ساعت در روز - ۲۴ساعته -۱یا۲رقمG+۱۹۰۷۰۰ - ۲۳ساعت در روز - ۲۴ساعته -۲رقمیH+۱۰۰ | ۱نشانگر طولانی بودن روز = ۱I!بیست و نهدویک تا سی و یکشماره ی روز از ماه به حروفJ!۸۳.۳۱۴۱۰۰ - ۰(\*\*.?) در صد گذشته از سالK+۰۱۰ | ۱سال : کبیسه=۱ و غیر کبیسه=۰L+دیخرفر تا اس‍نام ماه از سال - خلاصهM+۳۷۱ - ۷یک شنبه=۱ ،عدد روز در هفته (IR)N++۰۳۳۰+۰۴۳۰-۱۲۰۰ ، +۱۴۰۰":" اختلاف ساعت جهانی - بدونO++۰۳:۳۰+۰۴:۳۰-۱۲:۰۰ ، +۱۴:۰۰":" اختلاف ساعت جهانی - باP!۶۱۳۲۴(۳۶۵|۳۶۴) - ۰تعداد روز (کامل) باقی مانده از سالQ+امامام"واژه ی "امS+IRSTIRDTمخفف مناطقمخفّف منطقه ی زمانی تنظیم شدهT+۱۲۹۵۴۳۶۴۶۷۱۲۴۳۹۵۵۳۴۶: طبق نمونهtimestamp (Unix) برچسب زمانیU!هزار و سیصد و هشتاد و نههزار و سیصد و نود و یک: طبق نمونهسال به حروف - کاملV+۴۳۱۱۰۰ - (۵۲|۵۳)شماره ی این هفته در سال - ۲رقمW+۱۳۸۹۱۳۹۱: طبق نمونهسال (به عدد) چهار رقمیY+۱۲۶۰۰۱۶۲۰۰-۴۳۲۰۰ ، ۵۰۴۰۰اختلاف ساعت جهانی به ثانیهZ

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity67

Established project with proven stability

 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

Every ~81 days

Recently: every ~94 days

Total

6

Last Release

3526d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/46e7d558a025948fb1d5c0941349f919699cf468995cd5d5c3d56dc8a39072db?d=identicon)[motammem](/maintainers/motammem)

---

Top Contributors

[![motammem](https://avatars.githubusercontent.com/u/5410340?v=4)](https://github.com/motammem "motammem (25 commits)")

---

Tags

farsi-calendarfarsi-datetimejalali-calendarjalali-datetimepersian-calendarpersiandate-instancephp-standard-datetimeshamsi-date-picker

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[phpflo/phpflo

Flow-based programming for PHP

2173.3k4](/packages/phpflo-phpflo)[jaspaul/laravel-rollout

A package to integrate rollout into your Laravel project.

2493.8k](/packages/jaspaul-laravel-rollout)

PHPackages © 2026

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