PHPackages                             novaday-co/laravel-persian-datetime-helper - 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. novaday-co/laravel-persian-datetime-helper

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

novaday-co/laravel-persian-datetime-helper
==========================================

Persian DateTime Helper for Laravel

513PHP

Since Sep 20Pushed 4y ago2 watchersCompare

[ Source](https://github.com/novaday-co/laravel-persian-datetime-helper)[ Packagist](https://packagist.org/packages/novaday-co/laravel-persian-datetime-helper)[ RSS](/packages/novaday-co-laravel-persian-datetime-helper/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Laravel Persian DateTime Helper
===============================

[](#laravel-persian-datetime-helper)

 [![GitHub code size in bytes](https://camo.githubusercontent.com/a3a6dc86694cdc344241b289120380158f892b5d9d4c1a1c4d9536e7b1ce1bdd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c616e6775616765732f636f64652d73697a652f6e6f76616461792d636f2f6c61726176656c2d7065727369616e2d6461746574696d652d68656c7065722e737667)](https://camo.githubusercontent.com/a3a6dc86694cdc344241b289120380158f892b5d9d4c1a1c4d9536e7b1ce1bdd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c616e6775616765732f636f64652d73697a652f6e6f76616461792d636f2f6c61726176656c2d7065727369616e2d6461746574696d652d68656c7065722e737667) [![GitHub](https://camo.githubusercontent.com/0c4a22c400d361838d900650c652c7ea7647d37eb4f9e171c4d83b1c46af97ce/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6e6f76616461792d636f2f6c61726176656c2d7065727369616e2d6461746574696d652d68656c7065722e737667)](https://camo.githubusercontent.com/0c4a22c400d361838d900650c652c7ea7647d37eb4f9e171c4d83b1c46af97ce/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6e6f76616461792d636f2f6c61726176656c2d7065727369616e2d6461746574696d652d68656c7065722e737667)

Install
-------

[](#install)

### Composer

[](#composer)

Installing with composer is recommended and it simply works :

```
composer require novaday-co/laravel-persian-datetime-helper

```

### Download

[](#download)

You can download latest version from the Github: Download

Quick start
-----------

[](#quick-start)

To use in your project, just import `DateTimeHelper` class :

```
$instance = DateTimeHelper::parse('1400-04-13 15:16:10') : Jalalian
$instance = DateTimeHelper::parse('1400/04/13 15:16:10') : Jalalian
$instance = DateTimeHelper::parse('1400_04_13 15:16:10') : Jalalian

DateTimeHelper::parse('1400-04-13 15:16:10')->format('Y-m-d') : string
// 1400-04-13

DateTimeHelper::parse('1400/04/13 15:16:10')->format('Y/m/d') : string
// 1400/04/13
```

---

```
// Accept H:i Format

DateTimeHelper::parse('1400/04/13 15:16')->format('Y-m-d H:i:s') :  string ('Y-m-d H:i:s')
// 1400-04-13 15:16:00
```

---

```
// Clone

$jalaliDateTime = DateTimeHelper::parse('1400-04-13 15:16:10');
$cloneJalaliDateTime = DateTimeHelper::copy($jalaliDateTime)->format('Y-m-d H:i:s');
// 1400-04-13 15:16:10
// $jalaliDateTime == $cloneJalaliDateTime
// $jalaliDateTime !== $cloneJalaliDateTime
```

---

```
//ignore multiple space from input

$instance = DateTimeHelper::parse('1400-04-13   15:16:10')->format('Y-m-d H:i:s') : string
// 1400-04-13 15:16:10
```

---

```
DateTimeHelper::jalaliToGregorian('1400-04-13 15:16:10') : string ('Y-m-d H:i:s')
// 2021-07-04 15:16:10

DateTimeHelper::jalaliToGregorian('1400-04-13') : string ('Y-m-d H:i:s')
// 2021-07-04 00:00:00
```

---

```
DateTimeHelper::jalaliDiffInMonths('1400-02-23 10:27:52', '1400-04-23 15:16:10') : int
// 2

DateTimeHelper::jalaliDiffInMonths('1400-02-23', '1400-04-23') : int
// 2
```

---

```
DateTimeHelper::jalaliDiffInDays('1400-02-13 15:16:10', '1400-02-23 10:27:52') : int
// 9

DateTimeHelper::jalaliDiffInDays('1400-02-13', '1400-02-23') : int
// 10
```

---

```
DateTimeHelper::jalaliDiffInHours('1400-04-23 15:16:10', '1400-04-23 22:27:52') : int
// 7

DateTimeHelper::jalaliDiffInHours('15:16:10', '22:27:52') : int
// 7
```

---

```
DateTimeHelper::jalaliDiffInMinutes('1400-04-23 15:16:10', '1400-04-23 22:27:52') : int
// 431

DateTimeHelper::jalaliDiffInMinutes('15:16:10', '22:27:52') : int
// 431
```

---

```
DateTimeHelper::clearTime('1400-04-23 15:16:10') :  string ('Y-m-d H:i:s')
// 1400-04-23 00:00:00
```

---

```
DateTimeHelper::getMinutes('1400-04-23 15:16:10') :  int
// 916 = 15*60 + 16
```

---

```
DateTimeHelper::firstDayOfMonth('1400-04-23 15:16:10') :  string ('Y-m-d H:i:s')
// 1400-04-01 00:00:00

DateTimeHelper::firstDayOfMonth('1400-04-23') :  string ('Y-m-d H:i:s')
// 1400-04-01 00:00:00
```

---

```
DateTimeHelper::lastDayOfMonth('1400-04-23 15:16:10') :  string ('Y-m-d H:i:s')
// 1400-04-31 00:00:00

DateTimeHelper::lastDayOfMonth('1400-08-23') :  string ('Y-m-d H:i:s')
// 1400-08-30 00:00:00
```

---

```
DateTimeHelper::firstDayOfYear() :  string ('Y-m-d H:i:s')
// 1400-01-01 00:00:00
```

---

```
DateTimeHelper::lastDayOfYear() :  string ('Y-m-d H:i:s')
// 1400-12-29 23:59:59
```

License
-------

[](#license)

### MIT

[](#mit)

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity28

Early-stage or recently created project

 Bus Factor1

Top contributor holds 92.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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/8b3b38fb2c7f00f927b5a43b63d82afb44e4b884714b1b5d5da3eb4502100d84?d=identicon)[faridfr](/maintainers/faridfr)

---

Top Contributors

[![hosein-xz](https://avatars.githubusercontent.com/u/25554655?v=4)](https://github.com/hosein-xz "hosein-xz (35 commits)")[![faridfr](https://avatars.githubusercontent.com/u/9497923?v=4)](https://github.com/faridfr "faridfr (3 commits)")

---

Tags

helper-functionsjalali-datetimelaravelpersian-datetimephp

### Embed Badge

![Health badge](/badges/novaday-co-laravel-persian-datetime-helper/health.svg)

```
[![Health](https://phpackages.com/badges/novaday-co-laravel-persian-datetime-helper/health.svg)](https://phpackages.com/packages/novaday-co-laravel-persian-datetime-helper)
```

###  Alternatives

[stuttter/wp-user-profiles

A sophisticated way to edit users in WordPress

11219.3k1](/packages/stuttter-wp-user-profiles)[fof/analytics

Tracks analytics using Google Analytics, Google Optimize/GTM and Matomo

3543.1k](/packages/fof-analytics)[malarzm/collections

Various implementations of Doctrine's Collection interface

2368.1k](/packages/malarzm-collections)[chrico/wp-fields

Package which provides some re-usable fields for WordPress.

1981.2k](/packages/chrico-wp-fields)[aertmann/history

An improved history backend module for Neos

1070.2k](/packages/aertmann-history)

PHPackages © 2026

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