rmunate / calendario-colombia
This package simplifies working with Colombian holidays. It provides an easy, reliable, and convenient way to query, manipulate, or retrieve data related to holidays in Colombia, including detailed information about the reasons for each holiday.
Requires
- php: ^7.4 || ^8.0
- ext-pdo: *
- ext-pdo_sqlite: *
- illuminate/database: ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0 || ^13.0
- illuminate/support: ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0 || ^13.0
- nesbot/carbon: ^2.72.2 || ^3.0
Requires (Dev)
- ext-calendar: *
- illuminate/config: ^8.0 || ^9.0 || ^10.0 || ^11.0 || ^12.0 || ^13.0
- phpunit/phpunit: ^9.6 || ^11.5 || ^12.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Consulta los festivos nacionales y los domingos de Colombia del 2000 al 2100, inclusive. El paquete distribuye un archivo SQLite de solo lectura y no necesita una API externa, migraciones ni tablas en la base de datos de tu aplicación.
Instalación
La versión 4.0.0 es compatible con Laravel 8 a 13. Laravel 13 requiere PHP 8.3 o posterior; para las versiones anteriores, usa una versión de PHP compatible con tu aplicación (como mínimo PHP 7.4 para este paquete). El controlador pdo_sqlite debe estar habilitado.
composer require "rmunate/calendario-colombia:^4.0"
Uso rápido
use Rmunate\Calendar\Colombia; Colombia::isHoliday('2026-07-13'); // true Colombia::getDescriptionIfHoliday('2026-07-13'); // 'Día de Nuestra Señora del Rosario de Chiquinquirá' // Festivos nacionales de 2026, sin incluir los domingos que no son festivo nacional. $festivos = Colombia::where('year', 2026) ->where('holiday_reason', '!=', 'Día Domingo Festivo') ->orderBy('full_date') ->get();
El calendario aplica la Ley 51 de 1983 e incorpora desde 2026 el festivo de Chiquinquirá (Ley 2578 de 2026, art. 6). Los años futuros se proyectan con estas reglas; no se incluyen días cívicos, regionales o excepcionales.
Consulta la documentación completa o las notas de la versión 4.0.0.