PHPackages                             palmabit/holidays - 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 &amp; Helpers](/categories/utility)
4. /
5. palmabit/holidays

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

palmabit/holidays
=================

holidays

0.0.2(10y ago)324MITPHPPHP &gt;=5.4.0

Since Nov 19Pushed 7y ago3 watchersCompare

[ Source](https://github.com/Palmabit-IT/holidays)[ Packagist](https://packagist.org/packages/palmabit/holidays)[ Docs](https://github.com/Palmabit-IT/holidays)[ RSS](/packages/palmabit-holidays/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (3)Versions (3)Used By (0)

Holidays
========

[](#holidays)

[![Latest Version on Packagist](https://camo.githubusercontent.com/5dbf1dae4e6e73bd2e68183f8b277937a60b91e6dcb2769fec6f08a495523392/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70616c6d616269742f686f6c69646179732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/palmabit/holidays)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/595a32019b33889e8f16f4b23b4c03fe56c36b85af5ebb6587c3de41fa774cfa/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f50616c6d616269742d49542f686f6c69646179732f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/Palmabit-IT/holidays)[![Coverage Status](https://camo.githubusercontent.com/2e6eaee26bcdffec382274129e699b409ad402955d3e08db6ae59ed3786cf016/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f50616c6d616269742d49542f686f6c69646179732e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/Palmabit-IT/holidays/code-structure)[![Quality Score](https://camo.githubusercontent.com/1bbe6ed163dca826f4948d90524612ef50622179d045979d82880212e775d777/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f50616c6d616269742d49542f686f6c69646179732e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/Palmabit-IT/holidays)

Country holidays days.

###### NOTE: Only italian holidays days are available for now.

[](#note-only-italian-holidays-days-are-available-for-now)

Install
-------

[](#install)

Via Composer

```
$ composer require palmabit/holidays
```

Usage
-----

[](#usage)

```
$year = 2025;

/*
 * Current year is set if no argument are passed.
 */
$holidays = new Palmabit\Holidays\Holidays($year);
```

or

```
Palmabit\Holidays\Holidays::setYear($year);
$holidays = new Holidays();
```

then

```
$holidays = new Palmabit\Holidays\Holidays(2016);

/*
 * return an array of all italian holidays
 */
 $it_holidays = $holidays
               ->setCountry('it_IT')
               ->all();
```

Change log
----------

[](#change-log)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Testing
-------

[](#testing)

```
$ composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

TODO
----

[](#todo)

- Improve coverage
- Add other country holidays days

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Palmabit Srl](https://github.com/Palmabit-IT)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor3

3 contributors hold 50%+ of commits

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

2

Last Release

3878d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3f0f7d5e84f32a9208f1c2ccd68555592e276d1fffb73ecfe76451c04786b4e1?d=identicon)[palmabit](/maintainers/palmabit)

---

Top Contributors

[![ceccode](https://avatars.githubusercontent.com/u/1024055?v=4)](https://github.com/ceccode "ceccode (7 commits)")[![philsturgeon](https://avatars.githubusercontent.com/u/67381?v=4)](https://github.com/philsturgeon "philsturgeon (5 commits)")[![RobLoach](https://avatars.githubusercontent.com/u/25086?v=4)](https://github.com/RobLoach "RobLoach (4 commits)")[![marcqualie](https://avatars.githubusercontent.com/u/101022?v=4)](https://github.com/marcqualie "marcqualie (4 commits)")[![bcrowe](https://avatars.githubusercontent.com/u/752603?v=4)](https://github.com/bcrowe "bcrowe (2 commits)")[![Swader](https://avatars.githubusercontent.com/u/1430603?v=4)](https://github.com/Swader "Swader (1 commits)")[![Anahkiasen](https://avatars.githubusercontent.com/u/1321596?v=4)](https://github.com/Anahkiasen "Anahkiasen (1 commits)")[![zackkitzmiller](https://avatars.githubusercontent.com/u/111536?v=4)](https://github.com/zackkitzmiller "zackkitzmiller (1 commits)")[![barryvdh](https://avatars.githubusercontent.com/u/973269?v=4)](https://github.com/barryvdh "barryvdh (1 commits)")[![bencorlett](https://avatars.githubusercontent.com/u/181919?v=4)](https://github.com/bencorlett "bencorlett (1 commits)")[![nyamsprod](https://avatars.githubusercontent.com/u/51073?v=4)](https://github.com/nyamsprod "nyamsprod (1 commits)")[![pborreli](https://avatars.githubusercontent.com/u/77759?v=4)](https://github.com/pborreli "pborreli (1 commits)")

---

Tags

holidaysdistance

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/palmabit-holidays/health.svg)

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

###  Alternatives

[illuminate/support

The Illuminate Support package.

630113.0M40.8k](/packages/illuminate-support)[spatie/holidays

Calculate public holidays

402860.1k2](/packages/spatie-holidays)[craftcms/feed-me

Import content from XML, RSS, CSV or JSON feeds into entries, categories, Craft Commerce products, and more.

293952.6k30](/packages/craftcms-feed-me)[solspace/craft-freeform

The most flexible and user-friendly form building plugin!

54681.3k17](/packages/solspace-craft-freeform)[pimcore/data-importer

Adds a comprehensive import functionality to Pimcore Datahub

46855.5k5](/packages/pimcore-data-importer)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)

PHPackages © 2026

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