PHPackages gs-nasc/brazil-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. gs-nasc/brazil-holiday ActiveLibrary gs-nasc/brazil-holiday ====================== PHP Package thats verify if date is or not a holiday. 1.0.4(5y ago)10834↓100%1MITPHP Since Jan 26Pushed 4y ago1 watchersCompare [ Source](https://github.com/gs-nasc/BrazilHoliday)[ Packagist](https://packagist.org/packages/gs-nasc/brazil-holiday)[ RSS](/packages/gs-nasc-brazil-holiday/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (5)DependenciesVersions (6)Used By (0) Brazil Holiday ============== [](#brazil-holiday) Brazil Holiday é uma biblioteca PHP que diz se um dia é ou não feriado, por enquanto temos só os feriados mais importantes mas estamos em constante atualização e sempre adicionando novos feriados! [![Bugs](https://camo.githubusercontent.com/f0ef8c7044df9a2919dece2858b3371ffeb9eb12696298b6f8ec91287b4743cb/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d67732d6e6173635f4272617a696c486f6c69646179266d65747269633d62756773)](https://sonarcloud.io/dashboard?id=gs-nasc_BrazilHoliday)[![Code Smells](https://camo.githubusercontent.com/27bb42193bbf0b99fc5d6cfe0018023aa0f8c403661f1b255f8c61f3c553199a/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d67732d6e6173635f4272617a696c486f6c69646179266d65747269633d636f64655f736d656c6c73)](https://sonarcloud.io/dashboard?id=gs-nasc_BrazilHoliday)[![Maintainability Rating](https://camo.githubusercontent.com/f585a32ae216f48fb2848bbf4716005d2cf37527b2406bb6553bb5213b2ed7bf/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d67732d6e6173635f4272617a696c486f6c69646179266d65747269633d7371616c655f726174696e67)](https://sonarcloud.io/dashboard?id=gs-nasc_BrazilHoliday)[![Security Rating](https://camo.githubusercontent.com/abe3c5b45dcc39620ec2e60d97e3369dbd47a36aafb9510c449287d319452818/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d67732d6e6173635f4272617a696c486f6c69646179266d65747269633d73656375726974795f726174696e67)](https://sonarcloud.io/dashboard?id=gs-nasc_BrazilHoliday)[![Reliability Rating](https://camo.githubusercontent.com/2508bb1f1ed6b0f0c715dc53e9110bd6347bda6975ff1c36b3d2876017393240/68747470733a2f2f736f6e6172636c6f75642e696f2f6170692f70726f6a6563745f6261646765732f6d6561737572653f70726f6a6563743d67732d6e6173635f4272617a696c486f6c69646179266d65747269633d72656c696162696c6974795f726174696e67)](https://sonarcloud.io/dashboard?id=gs-nasc_BrazilHoliday)[![](https://camo.githubusercontent.com/8cbbe1d35a1f1206b0f25c5aedf8079b927d5d4b372aac69b5e82f8aae99b3b7/68747470733a2f2f7777772e636f6465666163746f722e696f2f436f6e74656e742f6261646765732f41506c75732e737667)](https://www.codefactor.io/repository/github/gs-nasc/brazilholiday) Começando ========= [](#começando) ### Instalando [](#instalando) A biblioteca pode ser instalada pelo composer (e é o mais recomendado), o comando para instalar é este abaixo: ``` composer require gs-nasc/brazil-holiday ``` via [Packagist](https://packagist.org/packages/gs-nasc/brazil-holiday) ### Implementando [](#implementando) A biblioteca é de fácil implementação e utilização abaixo estão códigos de exemplo: Obs. ****lembre-se de carregar o autoload do composer**** #### Qualquer data [](#qualquer-data) ``` use BrazilHoliday\Holiday; $holiday = new Holiday(); // Aqui carregamos o ano que vamos usar para encontrarmos o feriado // Somente feriados que não são dias úteis (Ex: Natal) $holiday->load(2021); // Todos os feriados ( Ex: Dia da Bandeira ) $holiday->load(2021, "all"); // troque 2021 pelo ano que irá utilizar // No lugar de 01/01/2021 coloque a data que você quer //saber se é feriado, siga o padrão que está ali! $date = DateTime::createFromFormat('d/m/Y', '01/01/2021'); // Finalmente verificamos se é ou não feriado $feriado = $holiday->isHoliday($date); echo ($feriado) ? "Feriado " . $feriado->title : "Não é feriado"; // OU if($feriado) { $foo = "Feriado " . $feriado->title; }else{ $foo = "Não é feriado"; } echo $foo; ``` #### Hoje [](#hoje) ``` use BrazilHoliday\Holiday; $holiday = new Holiday(); // Aqui carregamos o ano que vamos usar para encontrarmos o feriado // Somente feriados que não são dias úteis (Ex: Natal) $holiday->load(2021); // Todos os feriados ( Ex: Dia da Bandeira ) $holiday->load(2021, "all"); // troque 2021 pelo ano que irá utilizar // Finalmente verificamos se é ou não feriado $feriado = $holiday->todayHoliday(); echo ($feriado) ? "Feriado " . $feriado->title : "Não é feriado"; // OU if($feriado) { $foo = "Feriado " . $feriado->title; }else{ $foo = "Não é feriado"; } echo $foo; ``` #### Amanhã [](#amanhã) ``` use BrazilHoliday\Holiday; $holiday = new Holiday(); // Aqui carregamos o ano que vamos usar para encontrarmos o feriado // Somente feriados que não são dias úteis (Ex: Natal) $holiday->load(2021); // Todos os feriados ( Ex: Dia da Bandeira ) $holiday->load(2021, "all"); // troque 2021 pelo ano que irá utilizar // Finalmente verificamos se é ou não feriado $feriado = $holiday->tomorrowHoliday(); echo ($feriado) ? "Feriado " . $feriado->title : "Não é feriado"; // OU if($feriado) { $foo = "Feriado " . $feriado->title; }else{ $foo = "Não é feriado"; } echo $foo; ``` #### Ontem [](#ontem) ``` use BrazilHoliday\Holiday; $holiday = new Holiday(); // Aqui carregamos o ano que vamos usar para encontrarmos o feriado // Somente feriados que não são dias úteis (Ex: Natal) $holiday->load(2021); // Todos os feriados ( Ex: Dia da Bandeira ) $holiday->load(2021, "all"); // troque 2021 pelo ano que irá utilizar // Finalmente verificamos se é ou não feriado $feriado = $holiday->yesterdayHoliday(); echo ($feriado) ? "Feriado " . $feriado->title : "Não é feriado"; // OU if($feriado) { $foo = "Feriado " . $feriado->title; }else{ $foo = "Não é feriado"; } echo $foo; ``` Quando é feriado a biblioteca retorna um objeto com os seguintes atributos: - title (Título do feriado. Ex: Ano Novo) - date (Data do feriado. Ex: 01/01/2021) - type (Tipo do feriado. Ex: Feriado Nacional) Quando não é feriado a biblioteca retorna `false` Como ajudar? ============ [](#como-ajudar) Se você está sentindo falta de algum feriado ou quer arrumar algum bug que encontrou siga os passos abaixo: Adicionar novo feriado ---------------------- [](#adicionar-novo-feriado) ### Feriado Fixo [](#feriado-fixo) Para adicionar um novo feriado fixo (Ex: Natal) é só fazer um fork deste respositório e editar o arquivo [dates.json](https://github.com/gs-nasc/BrazilHoliday/blob/main/src/dates.json) que se econtra na pasta `src/` seguindo seus padrões, quando terminar é só fazer um Pull Request que eu analizarei o pedido e caso se enquadre na Biblioteca adicionarei no projeto. ### Feriado Móvel [](#feriado-móvel) Para adicionar um novo feriado móvel basta abrir uma Issue dizendo qual o feriado que eu buscarei um método de adiciona-lo no projeto Arrumar Bug ----------- [](#arrumar-bug) Caso queira arrumar algum bug é só fazer fork do projeto, arrumar o bug e fazer testes para ver se tudo continua funcionando, caso tudo funcione fazer um Pull Request para ser implementado. Tabela de Feriados Disponíveis ------------------------------ [](#tabela-de-feriados-disponíveis) StatusAno Novo✔️Dia Internacional da Mulher✔️Dia da Mentira✔️Dia do Índio✔️Tiradentes✔️Descobrimento do Brasil✔️Dia do Trabalhador✔️Dia da Abolição da Escravatura✔️Dia Mundial do Meio Ambiente✔️Dia dos Namorados✔️Dia de São João✔️Dia do Amigo✔️Dia dos Avós✔️Dia do Estudante✔️Dia do Folclore✔️Dia do Soldado✔️Independência do Brasil✔️Dia da Árvore✔️Dia Internacional da Paz✔️Dia das Crianças✔️Nossa Senhora Aparecida✔️Dia do Professor✔️Dia Nacional do Livro✔️Halloween✔️Finados✔️Proclamação da República✔️Dia da Bandeira✔️Dia Nacional da Consciência Negra✔️Dia Internacional dos Direitos Humanos✔️Véspera de Natal✔️Natal✔️Véspera de Ano Novo✔️Carnaval✔️Páscoa✔️Sexta-Feira Santa✔️Corpus Christ✔️Dia da Mães✔️Dia dos Pais✔️Dia do Servidor Público✔️ ### Health Score 30 — LowBetter than 64% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity22 Limited adoption so far Community8 Small or concentrated contributor base Maturity57 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. ### Release Activity Cadence Every ~0 days Total 5 Last Release 1930d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/f067e9fdb986a3ee71b6fa2b7b6260e071326375af6d696845d9ace0d1b4dd03?d=identicon)[Naxsi](/maintainers/Naxsi) --- Top Contributors [![gs-nasc](https://avatars.githubusercontent.com/u/48607315?v=4)](https://github.com/gs-nasc "gs-nasc (22 commits)") --- Tags ano-novobrasilbrasileirobrazil-holidayscomposer-packageferiadosferiados-brasilferiados-brasileirosferiados-nacionaisholidayslibrarynatalphpphp-libraryphp7 ### Embed Badge ![Health badge](/badges/gs-nasc-brazil-holiday/health.svg) ``` [![Health](https://phpackages.com/badges/gs-nasc-brazil-holiday/health.svg)](https://phpackages.com/packages/gs-nasc-brazil-holiday) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)