PHPackages                             pasoonate/pasoonate-php - 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. pasoonate/pasoonate-php

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

pasoonate/pasoonate-php
=======================

v1.1.2(1y ago)86.0k↓81.2%2[1 PRs](https://github.com/pasoonate/pasoonate-php/pulls)MITPHPPHP >=7.2CI failing

Since Apr 14Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/pasoonate/pasoonate-php)[ Packagist](https://packagist.org/packages/pasoonate/pasoonate-php)[ RSS](/packages/pasoonate-pasoonate-php/feed)WikiDiscussions master Synced 1w ago

READMEChangelog (10)Dependencies (1)Versions (30)Used By (0)

📅 PHP & Laravel Calendar - Pasoonate
========================================

[](#-php--laravel-calendar---pasoonate)

Pasoonate is a powerful library that provides advanced date-time methods and supports multiple calendars! 🚀

---

🛠 Running Tests
---------------

[](#-running-tests)

```
composer install
./vendor/bin/phpunit
```

📥 Installation (via [Composer](https://getcomposer.org))
--------------------------------------------------------

[](#-installation-via-composer)

```
composer require pasoonate/pasoonate-php
```

---

🎯 Usage
-------

[](#-usage)

```
use Pasoonate\Pasoonate;

function pasoonate(): CalendarManager
{
    return Pasoonate::make();
}

// Set timestamp 📌
$date = pasoonate()->setTimestamp(1333857600)->jalali()->format('yyyy-MM-dd');

// Convert Jalali to Gregorian 🌍
$datetime = pasoonate()->jalali('1398/02/01 20:00:00')->gregorian()->getDatetime();

// Get today's date in different calendars 📆
$date = pasoonate()->jalali()->format('yyyy-MM-dd'); // 1403-10-29 🏷️
$date = pasoonate()->gregorian()->format('yyyy-MM-dd'); // 2025-01-18 📅
$date = pasoonate()->islamic()->format('yyyy-MM-dd'); // 1446-07-18 🌙
$date = pasoonate()->shia()->format('yyyy-MM-dd'); // 1446-07-17 ✨

// Date conversion 🔄
$date = pasoonate()->jalali()->addDay(2)->gregorian()->format('yyyy-MM-dd');

// Parse and format dates 📖
pasoonate()->jalali()->parse('yyyy-MM-dd', '1403-10-10')->addDay(3)->format('yyyy-MM-dd'); //1403-10-13
```

---

🌍 Supported Calendars
---------------------

[](#-supported-calendars)

- 📅 **Gregorian**
- 🇮🇷 **Jalali**
- 🕌 **Islamic**
- ⚫ **Shia**

---

📌 Commonly Used Date Functions in Projects
------------------------------------------

[](#-commonly-used-date-functions-in-projects)

### ✅ Get Today's Date

[](#-get-todays-date)

```
$today = pasoonate()->jalali()->format('Y/m/d');
```

### 🔄 Convert Jalali to Gregorian

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

```
$gregorianDate = pasoonate()->jalali('1403/10/10')->gregorian()->format('Y-m-d');
```

### 🔁 Convert Gregorian to Jalali

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

```
$jalaliDate = pasoonate()->gregorian('2025-01-18')->jalali()->format('Y/m/d');
```

### ⏳ Get Start and End of the Month

[](#-get-start-and-end-of-the-month)

```
$startOfMonth = pasoonate()->jalali()->startOfMonth()->format('Y/m/d');
$endOfMonth = pasoonate()->jalali()->endOfMonth()->format('Y/m/d');
```

### 🕰️ Get Start and End of the Year

[](#️-get-start-and-end-of-the-year)

```
$startOfYear = pasoonate()->jalali()->startOfYear()->format('Y/m/d');
$endOfYear = pasoonate()->jalali()->endOfYear()->format('Y/m/d');
```

### 📆 Check Leap Year

[](#-check-leap-year)

```
$isLeap = pasoonate()->jalali()->isLeapYear(); // Returns true or false
```

### 🗓️ Get Day of the Week

[](#️-get-day-of-the-week)

```
$dayOfWeek = pasoonate()->jalali()->dayOfWeek(); // 0 = Saturday, 6 = Friday
```

### 📅 Get Week Number of the Year

[](#-get-week-number-of-the-year)

```
$weekNumber = pasoonate()->jalali()->weekOfYear();
```

---

🔑 Basic Methods
---------------

[](#-basic-methods)

- `getTimestamp()` 🕰️
- `getTimezoneOffset()` 🌎
- `getDatetime()` ⏳
- `getDate()` 📆
- `getTime()` ⏰
- `getYear()` 🎯
- `getMonth()` 📅
- `getDay()` 🏷️
- `getHour()` ⏳
- `getMinute()` ⏲️
- `getSecond()` 🕐
- `setTimestamp($timestampAsSeconds)` 🔄
- `setTimezoneOffset($offsetAsMinutes)` 🏝️
- `setDatetime($year, $month, $day, $hour, $minute, $second)` 🏗️
- `setDate($year, $month, $day)`
- `setTime($hour, $minute, $second)`
- `setYear($year)`
- `setMonth($month)`
- `setDay($day)`
- `setHour($hour)`
- `setMinute($minute)`
- `setSecond($second)`
- `setUTCDatetime($year, $month, $day, $hour, $minute, $second)`
- `setUTCDate($year, $month, $day)`
- `setUTCTime($hour, $minute, $second)`
- `setUTCYear($year)`
- `setUTCMonth($month)`
- `setUTCDay($day)`
- `setUTCHour($hour)`
- `setUTCMinute($minute)`
- `setUTCSecond($second)`
- `dayOfWeek()` *(from 0 for Saturday to 6 for Friday)*
- `dayOfYear()`
- `weekOfMonth()`
- `weekOfYear()`

---

➕ Addition & ➖ Subtraction Methods
--------------------------------------

[](#-addition---subtraction-methods)

### 📅 Add Year

[](#-add-year)

```
echo $today->jalali('1399/01/15 11:22:00')->addYear(1)->format('Y/m/d H:i:s');
// 🗓️ 1400/01/15 11:22:00
```

### 📆 Add Month

[](#-add-month)

```
echo $today->jalali()->addMonth(1)->format('Y/m/d H:i:s');
// 🗓️ 1400/02/15 11:22:00
```

### 📅 Add Day

[](#-add-day)

```
echo $today->jalali()->addDay(3)->format('Y/m/d H:i:s');
// 🗓️ 1400/02/18 11:22:00
```

### ⏳ Add Hour

[](#-add-hour)

```
echo $today->jalali()->addHour(4)->format('Y/m/d H:i:s');
// ⏳ 1400/02/18 15:22:00
```

### ⏲️ Add Minute

[](#️-add-minute)

```
echo $today->jalali()->addMinute(2)->format('Y/m/d H:i:s');
// ⏲️ 1400/02/18 15:24:00
```

### ⏰ Add Second

[](#-add-second)

```
echo $today->jalali()->addSecond(35)->format('Y/m/d H:i:s');
// ⏰ 1400/02/18 15:24:35
```

### 📅 Subtract Year

[](#-subtract-year)

```
echo $today->jalali()->subYear(1)->format('Y/m/d H:i:s');
// 📅 1399/02/18 15:24:35
```

### 📆 Subtract Month

[](#-subtract-month)

```
echo $today->jalali()->subMonth(1)->format('Y/m/d H:i:s');
// 📆 1399/01/18 15:24:35
```

### 🗓️ Subtract Day

[](#️-subtract-day)

```
echo $today->jalali()->subDay(3)->format('Y/m/d H:i:s');
// 🗓️ 1399/01/15 15:24:35
```

... *(and many more!)*

---

🚀 **Pasoonate** makes date handling in PHP and Laravel super easy! 🔥

💡 **Give it a ⭐ on GitHub if you find it useful!** 🌟

###  Health Score

48

—

FairBetter than 95% of packages

Maintenance66

Regular maintenance activity

Popularity28

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 54% 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 ~103 days

Recently: every ~34 days

Total

26

Last Release

367d ago

Major Versions

v0.2.5 → 1.0.02021-08-14

PHP version history (2 changes)v0.1PHP >=5.4

0.2.0PHP >=7.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/47ca7d89ddf7e0cd20c6c17b516919c1de6bf1af2702e37999ec296954ecf51a?d=identicon)[mb-programmer](/maintainers/mb-programmer)

---

Top Contributors

[![mbpcoder](https://avatars.githubusercontent.com/u/3877538?v=4)](https://github.com/mbpcoder "mbpcoder (54 commits)")[![ataiemajid63](https://avatars.githubusercontent.com/u/2689093?v=4)](https://github.com/ataiemajid63 "ataiemajid63 (45 commits)")[![sajadjanat](https://avatars.githubusercontent.com/u/45841783?v=4)](https://github.com/sajadjanat "sajadjanat (1 commits)")

---

Tags

calendargregorian-calendarhijri-calendarjalali-calendarpersian-calendarcalendardate-conversionhijri-calendarpersian-calendarGregorian Calendar

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pasoonate-pasoonate-php/health.svg)

```
[![Health](https://phpackages.com/badges/pasoonate-pasoonate-php/health.svg)](https://phpackages.com/packages/pasoonate-pasoonate-php)
```

###  Alternatives

[eluceo/ical

The eluceo/iCal package offers an abstraction layer for creating iCalendars. You can easily create iCal files by using PHP objects instead of typing your \*.ics file by hand. The output will follow RFC 5545 as best as possible.

1.2k17.5M47](/packages/eluceo-ical)[spatie/icalendar-generator

Build calendars in the iCalendar format

6787.4M9](/packages/spatie-icalendar-generator)[spatie/laravel-google-calendar

Manage events on a Google Calendar

1.4k1.5M21](/packages/spatie-laravel-google-calendar)[league/period

Time range API for PHP

7335.4M21](/packages/league-period)[aeon-php/calendar

PHP type safe, immutable calendar library

2079.7M16](/packages/aeon-php-calendar)[kigkonsult/icalcreator

iCalcreator is the PHP implementation of rfc2445/rfc5545 and rfc updates, management of calendar information

2462.6M16](/packages/kigkonsult-icalcreator)

PHPackages © 2026

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