yasumi

Introdução

Yasumi (japonês para 'Feriado'「休み」) é uma biblioteca PHP fácil que ajuda você a recuperar datas e nomes de feriados e outras celebrações especiais de vários países/estados. É baseado em cálculos e regras, evitando a necessidade de um banco de dados abrangente.

Existem muitos serviços que podem fornecer informações sobre férias, mas não são totalmente gratuitos ou oferecem apenas informações limitadas. Além disso, não existe hoje nenhuma biblioteca PHP exaustiva que cubra uma ampla variedade de feriados e países. A biblioteca Date_Holidays do PEAR foi uma tentativa semelhante, porém não é atualizada há muito tempo.

Destaques

O objetivo do Yasumi é ser poderoso e ao mesmo tempo leve, utilizando classes nativas do PHP sempre que possível. O cálculo do Yasumi é baseado no provedor (ou seja, por país/estado), facilitando a adição de novos provedores de férias que calculam feriados.

• PHP puro
• API simples
• Agnóstico em termos de estrutura
• Uso de provedores para estender e expandir facilmente novos feriados
• Provedores de férias comuns
• Contabiliza a data/hora em que os feriados foram oficialmente estabelecidos e/ou abolidos
• Filtros que permitem selecionar facilmente determinados tipos de feriados (Oficial, Observado, Bancário, Sazonal ou Outro)
• Traduções globais
• Consciente do fuso horário
• Implementa ArrayIterator para processar facilmente os feriados de um provedor
• Totalmente documentado
• Unidade totalmente testada
• Pronto para Composer, compatível com PSR-12 e PSR-4

Documentação

A documentação do Yasumi está disponível em https://www.yasumi.dev. Você encontrará todas as informações necessárias sobre como instalar o Yasumi e também receitas de como usar o Yasumi em seu projeto.

Blogue

Confira regularmente a seção do blog no site de documentação para obter as atualizações mais recentes. Mantendo você informado sobre quaisquer novidades, lançamentos, etc. em um prático formato de postagem de blog!

Contribuindo

As contribuições são incentivadas e bem-vindas; Fico sempre feliz em receber feedback ou receber solicitações no GitHub :) Crie problemas no Github para bugs e novos recursos e comente aqueles em que você está interessado.

Se você gosta do que estou fazendo, uma xícara extra de café será muito apreciada :). Seu apoio me ajuda a dedicar mais tempo a projetos de software de código aberto como este.

Licença

Yasumi é um software de código aberto licenciado sob a licença MIT (MIT). Consulte LICENÇA para obter mais informações.