PHPackages                             jalali-events/event - 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. jalali-events/event

ActiveLibrary

jalali-events/event
===================

jalali date event

v1.0.4(5y ago)3331MITPHPPHP ^7.1.8 || ^8.0

Since Nov 4Pushed 5y ago2 watchersCompare

[ Source](https://github.com/amirsobhani/jalali-events)[ Packagist](https://packagist.org/packages/jalali-events/event)[ RSS](/packages/jalali-events-event/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (6)Used By (0)

**اطلاعات روزهای شمسی / جلالی**

نصب
---

[](#نصب)

**برای نصب از دستور زیر استفاده کنید**

```
$ composer require jalali-events/event

```

نحوه استفاده
------------

[](#نحوه-استفاده)

\*\*اطلاعات یک روز\*\* ---

ارسال تاریخ میلادی

```
use JalaliEvents\DateEvent;

$date = '2020-11-03';

return DateEvent::day($date);
```

---

ارسال تاریخ شمسی

```
use JalaliEvents\DateEvent;

$date = '1399-08-13';

return DateEvent::day($date, 'jalali');
```

**خروجی به شکل زیر می باشد**

```
   "jdate": "1399-8-13",
   "date": "2020-11-03",
   "is_holiday": true,
   "events": [
       {
           "description": "روز دانش آموز",
           "additional_description": "",
           "is_religious": false
       },
       {
           "description": "میلاد رسول اکرم و امام جعفر صادق علیه السلام",
           "additional_description": "١٧ ربيع الاول",
           "is_religious": true
       },
       {
           "description": "اسپوتنیک ۲، نخستین فضاپیمایی که یک موجود زنده را به فضا برد توسط اتحاد جماهیر شوروی پرتاب شد.",
           "additional_description": "3 November",
           "is_religious": false
       },
       {
           "description": "زادروز آمارتیا سن برندهٔ هندی جایزه نوبل اقتصاد",
           "additional_description": "3 November",
           "is_religious": false
       },
       {
           "description": "الیمپ دگوژ نمایشنامه‌ نویس، فعال سیاسی و طرفدار الغای برده‌داری از نخستین فمنیست‌های اعدام شده است",
           "additional_description": "3 November",
           "is_religious": false
       }
   ]
```

---

**گرفتن اطلاعات چند روز براساس بازه ی زمانی**

---

ارسال تاریخ میلادی

```
use JalaliEvents\DateEvent;

$start_date = '2020-11-03';
$end_date = '2020-11-04';

return DateEvent::startEndDate($start_date, $end_date);
```

---

ارسال تاریخ شمسی

```
use JalaliEvents\DateEvent;

$start_date = '1399-08-13';
$end_date = '1399-08-14';

return DateEvent::startEndDate($start_date, $end_date, 'jalali');
```

**خروجی به شکل زیر می باشد**

```
{
        "jdate": "1399-8-13",
        "date": "2020-11-03",
        "is_holiday": true,
        "events": [
            {
                "description": "روز دانش آموز",
                "additional_description": "",
                "is_religious": false
            },
            {
                "description": "میلاد رسول اکرم و امام جعفر صادق علیه السلام",
                "additional_description": "١٧ ربيع الاول",
                "is_religious": true
            },
            {
                "description": "اسپوتنیک ۲، نخستین فضاپیمایی که یک موجود زنده را به فضا برد توسط اتحاد جماهیر شوروی پرتاب شد.",
                "additional_description": "3 November",
                "is_religious": false
            },
            {
                "description": "زادروز آمارتیا سن برندهٔ هندی جایزه نوبل اقتصاد",
                "additional_description": "3 November",
                "is_religious": false
            },
            {
                "description": "الیمپ دگوژ نمایشنامه‌ نویس، فعال سیاسی و طرفدار الغای برده‌داری از نخستین فمنیست‌های اعدام شده است",
                "additional_description": "3 November",
                "is_religious": false
            }
        ]
    },
    {
        "jdate": "1399-8-14",
        "date": "2020-11-04",
        "is_holiday": false,
        "events": [
            {
                "description": "روز فرهنگ عمومی",
                "additional_description": "",
                "is_religious": false
            },
            {
                "description": "تولد فردریک بانتینگ کاشف انسولین",
                "additional_description": "4 November",
                "is_religious": false
            },
            {
                "description": "درگذشت نورمن فاستر رمزی ، فیزیکدان آمریکایی، برندهٔ جایزه نوبل فیزیک سال ۱۹۸۹ به همراه هانس جرج دهملت و ولفگانگ پل",
                "additional_description": "4 November",
                "is_religious": false
            },
            {
                "description": "درگذشت مایکل کرایتون نویسنده، کارگردان، فیلم نامه نویس، پزشک و تهیه کننده تلویزیونی",
                "additional_description": "4 November",
                "is_religious": false
            },
            {
                "description": "زادروز محمدرضا اسحاقی گرجی، نوازنده و موسیقی‌دان مازندرانی",
                "additional_description": "",
                "is_religious": false
            }
        ]
    }
```

---

Thanks to [persiaoncalapi](https://persiancalapi.ir) that his codes are used in this package

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity62

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 ~0 days

Total

4

Last Release

2018d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/32c8dbabefc30d0c9f7ceef83801c3add1867374124b9349e09b53e4cda67185?d=identicon)[amirsobhani](/maintainers/amirsobhani)

---

Top Contributors

[![devilinfamous-bot](https://avatars.githubusercontent.com/u/252126803?v=4)](https://github.com/devilinfamous-bot "devilinfamous-bot (20 commits)")

---

Tags

datetimetimedatejalali\_datejalali timejalali eventjalali date eventjalali date holidayjalali event date holiday

### Embed Badge

![Health badge](/badges/jalali-events-event/health.svg)

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

###  Alternatives

[jenssegers/date

A date library to help you work with dates in different languages

1.8k11.2M80](/packages/jenssegers-date)[cakephp/chronos

A simple API extension for DateTime.

1.4k47.7M121](/packages/cakephp-chronos)[nesbot/carbon

An API extension for DateTime that supports 281 different languages.

169661.4M4.8k](/packages/nesbot-carbon)[carbonphp/carbon-doctrine-types

Types to use Carbon in Doctrine

213220.4M8](/packages/carbonphp-carbon-doctrine-types)[advmaker/carbon-period

Extension of nesbot/carbon plugin, to work with date period

10116.0k](/packages/advmaker-carbon-period)[p3ym4n/jdate

Date converter from Jalali to Georgian and vice versa. It has Carbon instance inside and it's Laravel friendly.

101.8k2](/packages/p3ym4n-jdate)

PHPackages © 2026

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