Download the PHP package rmunate/calendario-colombia without Composer

Calendario de Festivos Colombia

Este paquete cuenta con la capacidad de permitirte trabajar con las fechas festivas de Colombia. Con el uso de dos clases, podrás lograr resultados increíbles en tus proyectos. Seguramente te será de utilidad para proyectos donde requieras validar si una fecha es festiva, si un año es bisiesto, cuántos festivos existen entre un rango de fechas y mucho más. Este paquete cuenta actualmente con soporte desde el año 2000 hasta el 2034. Cada año iremos agregando más años, nuestro compromiso es que siempre cuentes con la información de al menos 10 años a futuro.

⚙️ Esta librería es compatible con Laravel 9.0 y versiones posteriores ⚙️

📖 DOCUMENTACIÓN EN INGLES 📖

Tabla de Contenido

• Introducción
• Instalación
• Uso de la Clase Calendar
  • Método today()
  • Método date()
  • Método timeZone()
  • Métodos de Asignación Encadenados
  • Métodos de Manipulación de Fechas
  • Métodos Directos
  • Métodos para Calcular Diferencias de Fechas
• Uso de la Clase Holidays
  • Métodos Disponibles para Trabajar con Festivos
• Creador
• Licencia

Introducción

Este paquete cuenta con dos clases de acceso a los métodos. La clase Calendar permitirá que trabajes con las fechas ejecutando tareas de trabajo de rangos, aumentos, disminuciones y muchas otras tareas útiles. La clase Holidays te permitirá trabajar de manera exclusiva con las fechas festivas. El paquete actualmente solo cuenta con soporte para Colombia.

Instalación

Para instalar la dependencia a través de Composer, ejecuta el siguiente comando:

Uso de la Clase Calendar

Para poder emplear los diferentes métodos disponibles en la clase, podrás inicializar su uso de tres formas diferentes:

Método today()

Este método inicializará la clase con la fecha actual de acuerdo a la zona horaria configurada en Laravel o de acuerdo a la zona horaria suministrada como argumento.

Método date()

Este método permite enviar una fecha específica para inicializar la clase.

Método timeZone()

Este método inicializa la clase con una zona horaria específica.

Métodos de Asignación Encadenados

A continuación, listamos los métodos disponibles dentro de la clase que podrás usar para concatenarlos entre sí y configurar la inicialización de la clase de una manera más clara y estructurada.

Método setTimezone()

Asignar una zona horaria después de los métodos inicializadores today() o date().

Método setDate()

Asignar una fecha en caso de que el método inicializador sea timeZone().

Métodos de Manipulación de Fechas

A continuación, listamos los métodos que podrás emplear anidados a cualquiera de los métodos de inicialización previamente mencionados. Para efectos de este manual, usaremos el método de inicialización date(), pero puedes usar cualquiera de los métodos mencionados anteriormente.

Métodos Directos

A continuación, se listan los métodos que no requieren una inicialización a través de una fecha o una zona horaria.

Métodos para Calcular Diferencias entre Fechas

Uso de la Clase Holidays

Con esta clase, podrás realizar diversas operaciones específicamente con las fechas festivas del país. Podrás inicializar la clase a través de la Clase Calendar o directamente usando Holidays.

Usando Calendar:

Usando Holidays:

Métodos Disponibles para Trabajar con Días Festivos

Podrás usar cualquiera de los siguientes métodos concatenándolos a las dos posibles maneras de inicializar la consulta de fechas festivas. Para efectos del manual, usaremos la clase Holidays.

Métodos Finales Diferentes a ->get()

Además del método get, tendrás la posibilidad de emplear los siguientes métodos finales.

Creador

• 🇨🇴 Raúl Mauricio Uñate Castro
• Email: [email protected]

Licencia

Este proyecto está bajo la Licencia MIT.

🌟 ¡Apoya mis proyectos! 🚀

Haz las contribuciones que consideres adecuadas; el código es completamente tuyo. Juntos, podemos hacer cosas increíbles y mejorar el mundo del desarrollo. Tu apoyo es invaluable. ✨

Si tienes ideas, sugerencias o simplemente quieres colaborar, estamos abiertos a todo. Únete a nuestra comunidad y sé parte de nuestro viaje hacia el éxito. 🌐👩‍💻👨‍💻