PHPackages                             robier/holiday - 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. robier/holiday

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

robier/holiday
==============

Library for calculating holidays

09PHP

Since Oct 15Pushed 10y ago1 watchersCompare

[ Source](https://github.com/robier/Holiday)[ Packagist](https://packagist.org/packages/robier/holiday)[ RSS](/packages/robier-holiday/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Holidays
========

[](#holidays)

Holidays project will solve you a problem of calculating holidays. No matter if they are fixed dates, floating dates or dates that depends of some other holiday. This library was developed in need for holiday calculation that is not fixed to specific country as almost any other library out there is.

Note that library does not support holidays lasting more than 1 day.

And it's easy to use:

```
use \Robier\Holiday\Holidays;

$holidays = new Holidays();
$holidays->registerFixed('new_year', 1, 1);
$holidays->registerFloating('us_labour_day', 'first Monday of September');
$holidays->register('easter', new Holidays\Easter());
// Ascension of Jesus accords 40 days after easter
$holidays->registerDependent('ascension_of_jesus', 'easter', 40);

// true if there is a holiday on that date, false otherwise
var_dump($holidays->isHolidayOn(1, 1, 2030));

// gets HolidayData object if holiday exists on that date, null otherwise
var_dump($holidays->getHolidayOn(1, 1, 2030));

// true if there is any holidays in that period, false otherwise
var_dump($holidays->areAnyHolidaysBetween('2018-07-04', '2018-09-15'));

// gets array of holidays for range
var_dump($holidays->getHolidaysBetween('2018-07-04', '2018-09-15'));

// array of all holidays
var_dump($holidays->getAllHolidaysFor(2015));
```

Also we really discourage use of timestamps with this library, we do not like them because they are really not precise with time zones and how PHP deals with them :)

Features
--------

[](#features)

- you can register 3 types of dates:
    - `fixed` where a holiday's date is always fixed (like new year)
    - `floating` where a holiday's date is not fixed (like easter)
    - `dependant` where one holiday depends upon some other holiday (it's `x` days before or after "main" holiday)
- you can check if holiday exists providing date
- also you can get holiday by providing date
- you can check if there are any holidays in date range
- also you can get holidays by providing date range
- you can get all holidays for specified year
- you can make you own holiday class definitions by just implementing `Calculable` interface (it can not be dependant holiday type)

Installation
------------

[](#installation)

This project requires PHP 5.5 or higher. Installation of this library is simple via composer, just run command

```
composer require robier/holiday

```

Contribute
----------

[](#contribute)

You can contribute via pull request.

Todo
----

[](#todo)

- add support for holidays that last more than 1 day
- add more default holidays
- increase test coverage

Licence
-------

[](#licence)

This library is developed under MIT licence.

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3607521?v=4)[Robert](/maintainers/robier)[@robier](https://github.com/robier)

---

Top Contributors

[![robier](https://avatars.githubusercontent.com/u/3607521?v=4)](https://github.com/robier "robier (13 commits)")

### Embed Badge

![Health badge](/badges/robier-holiday/health.svg)

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

PHPackages © 2026

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