PHPackages                             ricardokovalski/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. ricardokovalski/holidays

Abandoned → [ricardokovalski/holidays](/?search=ricardokovalski%2Fholidays)Library

ricardokovalski/holidays
========================

Biblioteca de feriados e datas comemorativas do Brasil

v1.1(5y ago)3126.9k↑113.6%1MITPHPPHP >=5.6CI failing

Since Jul 3Pushed 2y ago1 watchersCompare

[ Source](https://github.com/ricardokovalski/holidays)[ Packagist](https://packagist.org/packages/ricardokovalski/holidays)[ RSS](/packages/ricardokovalski-holidays/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (1)Versions (3)Used By (0)

ricardokovalski/holidays
========================

[](#ricardokovalskiholidays)

[![Latest Stable Version](https://camo.githubusercontent.com/b50642770b9f66e86a0b59c57baacd556e98b96db9784e21c1d2da21aea17e0f/68747470733a2f2f706f7365722e707567782e6f72672f7269636172646f6b6f76616c736b692f686f6c69646179732f762f737461626c65)](https://packagist.org/packages/ricardokovalski/holidays)[![Author](https://camo.githubusercontent.com/5406762d6977d05d5e513932f181eb61430e99583c1d932b14c4fb80a9080cfc/687474703a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d407269636172646f6b6f76616c736b692d626c75652e7376673f7374796c653d666c61742d737175617265)](https://github.com/ricardokovalski)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://github.com/thephpleague/glide-symfony/blob/master/LICENSE)

Instalação
----------

[](#instalação)

```
composer require ricardokovalski/holidays

```

Uso básico
----------

[](#uso-básico)

### Coleções

[](#coleções)

Para obter uma coleção com todos os feriados (nacionais e não nacionais) e outras datas, basta você seguir a demonstração abaixo.

```
use Holidays\Collections\AllHolidays;

$collection = new AllHolidays();
$collection->getCollection();
```

Agora se quiser uma coleção de feriados nacionais e ordenados por data em ordem crescente, basta seguir o exemplo abaixo.

```
use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$collection->orderByTimestamp()
    ->ascending()
    ->getCollection();
```

Quer saber qual é o primeiro registro da coleção, basta utiliza o método first().

```
use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$collection->orderByTimestamp()
    ->ascending()
    ->first();
```

E o último registro da coleção?

```
use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$collection->orderByTimestamp()
    ->ascending()
    ->last();
```

Filtrar por um período?

```
use Holidays\Collections\NationalHolidays;

$startDate = \DateTime::createFromFormat('d/m/Y', '01/01/2020');
$endDate = \DateTime::createFromFormat('d/m/Y', '30/06/2020');

$collection = new NationalHolidays();
$collection->between($startDate, $endDate)
    ->orderByTimestamp()
    ->ascending()
    ->getCollection();
```

Obter os feriados do próximo ano?

```
use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays(2021);
$collection->orderByTimestamp()
    ->ascending()
    ->getCollection();
```

### Holiday

[](#holiday)

Formatando o timestamp da data.

```
use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$holiday = $collection->orderByTimestamp()
    ->ascending()
    ->first();

$holiday->formatter('d/m/Y');
```

Avançando no tempo, obtendo a data do feriado do próximo ano.

```
use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$holiday = $collection->orderByTimestamp()
    ->ascending()
    ->first();

$holiday->next();
```

Obtendo a data do feriado do ano passado.

```
use Holidays\Collections\NationalHolidays;

$collection = new NationalHolidays();
$holiday = $collection->orderByTimestamp()
    ->ascending()
    ->first();

$holiday->previous();
```

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity37

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 98.9% 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 ~41 days

Total

2

Last Release

2103d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b6f26053587d0d30779f0864360da904b5227317480dc2ee00773ca8d1b7e280?d=identicon)[ricardokovalski](/maintainers/ricardokovalski)

---

Top Contributors

[![ricardokovalski](https://avatars.githubusercontent.com/u/13839909?v=4)](https://github.com/ricardokovalski "ricardokovalski (87 commits)")[![lisotton](https://avatars.githubusercontent.com/u/1653860?v=4)](https://github.com/lisotton "lisotton (1 commits)")

---

Tags

celebrationdateholidayholidaysnationaltimetimedateholidayholidayscelebrationnational

###  Code Quality

TestsPHPUnit

### Embed Badge

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

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

###  Alternatives

[azuyalabs/yasumi

The easy PHP Library for calculating holidays

1.1k11.4M26](/packages/azuyalabs-yasumi)[cakephp/chronos

A simple API extension for DateTime.

1.4k47.7M121](/packages/cakephp-chronos)[jenssegers/date

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

1.8k11.2M80](/packages/jenssegers-date)[nesbot/carbon

An API extension for DateTime that supports 281 different languages.

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

Types to use Carbon in Doctrine

218220.4M8](/packages/carbonphp-carbon-doctrine-types)[umulmrum/holiday

A PHP library to compute holidays. It's something :-)

92342.6k1](/packages/umulmrum-holiday)

PHPackages © 2026

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