Basicamente o título. Precisava de uma ferramenta que fizesse a validação no meu trabalho e não achei implementação confiável, então, como todo programador, criei a minha: https://www.npmjs.com/package/holidays-brazil
Espero que seja útil eventualmente para alguém.
Parabéns pela ideia, mas não ajuda muito.
Feriados não é algo tão simples para funcionar em um array fixo, infelizmente. Feriados tendem a mudar, até mesmo os federais. Até 2022, o dia da consciência negra não era um feriado. O feriado mudou. Nacionais/federais são um pouco mais difíceis mudar do que estaduais, mas os municipais vivem mudando, e não há fonte de dados que consiga manter todos esses feriados atualizados.
Meu sonho é ver um lugar onde feriados municipais, estaduais e federais estivessem todos centralizados em uma única fonte de informação, atualizada diariamente, por apenas um órgão (que deveria ser o governo, pois é ele quem atualiza estes dados).
Mas com um projeto que precise considerar feriados é muito difícil existir um cenário que precise apenas dos feriados federais e não de municipais e estaduais.
Fico feliz em ver o empenho, mas acredito fortemente que a nossa maior necessidade não pode ser suprida por nós.
Mas com um projeto que precise considerar feriados é muito difícil existir um cenário que precise apenas dos feriados federais e não de municipais e estaduais.
Sem contar que vai muito da necessidade também. Por exemplo, existem libs que possuem os feriados municipais de todos os mais de 5500 municípios brasileiros. Se seu projeto só precisa abranger meia dúzia de cidades, vale ou não a pena usar tal lib?
Também existem feriados específicos de cada contexto. Por exemplo, o judiciário tem alguns feriados próprios (como o Dia da Justiça - 8 de dezembro). No Dia do Servidor Público (28 de outubro) costuma ser ponto facultativo na maioria das repartições públicas. No Dia do Securitário muitas seguradoras não trabalham, e pra piorar, ele é comemorado na terceira segunda-feira de outubro. Outros seguem esta mesma lógica de "enésimo dia da semana" (como o dia das mães e dos pais).
O carnaval é mais complicado, porque somente a terça é oficialmente um feriado (mas se não me engano varia de um estado pra outro). A segunda costuma ser "extra-oficial", e a Quarta-feira de Cinzas é pior, porque a "tradição" é trabalhar meio período - seria um "meio feriado" então?
Se a API é de propósito geral, talvez possa incluir essas opções de maneira configurável (incluir ou não a segunda de carnaval, poder emendar se o feriado cai na terça ou quinta, etc). E é importante categorizar também, pois a distinção entre federal, estadual e municipal é crucial em muitos sistemas, além de indicar se é ponto facultativo, se ele só é aplicável a determinado contexto, etc.
Além disso, é interessante ter uma opção para retornar o nome. Não só como curiosidade, mas também porque a mesma data pode ser um feriado diferente em cada cidade, por exemplo.
Enfim, uma API completa de propósito geral teria este grau de complexidade. Mas se for só pra saber se uma data é ou não feriado, aí talvez não precise de tanto. Como sempre, tudo depende...
Bem daora, Yago!
Seria interessante integrar com o Brasil API, assim daria pra centralizar mais informações relacionadas a Brasil
Quando olhar pra data é importante lembrar que dependendo da hora e do timezone o dia ainda não mudou.
Ex.:
Para o dia/horário 2024-12-25T00:00:00Z.
No Brasil é 2024-12-24T21:00:00-03:00.
Logo não é feriado.
Vi a quarta versão ainda não estava com esse tipo de cobertura.