Download the PHP package aeunius/laravel-feriados-peru without Composer
On this page you can find all versions of the php package aeunius/laravel-feriados-peru. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download aeunius/laravel-feriados-peru
More information about aeunius/laravel-feriados-peru
Files in aeunius/laravel-feriados-peru
Package laravel-feriados-peru
Short Description Feriados nacionales del Perú y cálculo de días hábiles para plazos administrativos en Laravel.
License MIT
Homepage https://github.com/Aeunius/laravel-feriados-peru
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-feriados-peru
Laravel Feriados Perú
Feriados nacionales del Perú y cálculo de plazos en días hábiles para Laravel, como los cuenta la Ley 27444. Sin conectarse a ningún servicio externo.
Requisitos
- PHP 8.2 o superior
- Laravel 12 o 13
Instalación
El service provider y el facade Feriados se registran solos.
Uso
Las fechas se aceptan como texto ('2026-07-28') o como cualquier
DateTimeInterface. Solo cuenta el día, no la hora, y en la zona horaria de la
propia fecha. proximo() devuelve el primer feriado después de la fecha, sin
contar la fecha misma.
Días hábiles y plazos
Un día hábil no es feriado ni cae en fin de semana.
El cómputo sigue el TUO de la Ley 27444: el plazo en días se cuenta en días hábiles consecutivos (art. 145), a partir del día hábil siguiente a la notificación (art. 144). Por eso:
sumarDiasHabiles()no cuenta la fecha de partida. Con días negativos cuenta hacia atrás y con 0 devuelve la misma fecha.diasHabilesEntre()tampoco cuenta$desde, pero sí$hasta: es la inversa desumarDiasHabiles(). Si$hastaes anterior, el resultado es negativo.esVencido()compara contra hoy, en la zona horaria de la aplicación.
Los días no laborables del sector público también cortan el plazo; ver Días no laborables. Los feriados regionales cortan el plazo si los agregas; ver Ajustar el calendario.
Fin de semana
Por defecto, sábado y domingo no son hábiles. Para una entidad que atiende los sábados, publica la configuración:
y deja solo el domingo en config/feriados-peru.php:
Sin Laravel
El motor no necesita la aplicación:
Qué feriados incluye
Los del art. 6 del D. Leg. 713 y sus modificaciones: 16 en 2026.
| Fecha | Feriado | Desde |
|---|---|---|
| 1 ene | Año Nuevo | |
| Jueves y Viernes Santo | Según la Pascua | |
| 1 may | Día del Trabajo | |
| 7 jun | Batalla de Arica y Día de la Bandera | 2024 (Ley 31788) |
| 29 jun | San Pedro y San Pablo | |
| 23 jul | Día de la Fuerza Aérea del Perú | 2023 (Ley 31822) |
| 28 y 29 jul | Fiestas Patrias | |
| 6 ago | Batalla de Junín | 2022 (Ley 31530) |
| 30 ago | Santa Rosa de Lima | |
| 8 oct | Combate de Angamos | |
| 1 nov | Día de Todos los Santos | |
| 8 dic | Inmaculada Concepción | |
| 9 dic | Batalla de Ayacucho | 2022 (Ley 31381) |
| 25 dic | Navidad |
"Desde" es el primer año en que se aplicó el feriado. La Ley 31788 se publicó el 15 de junio de 2023, después del 7 de junio de ese año, así que el primer feriado fue en 2024.
La Pascua se calcula con el algoritmo de Butcher, válido para cualquier año del calendario gregoriano (desde 1583).
Días no laborables
Cada año el Gobierno declara por decreto supremo días no laborables para el sector público, casi siempre para armar feriados largos. No son feriados:
- Solo obligan al sector público, que compensa las horas después. El sector privado trabaja, salvo acuerdo con el empleador.
- Los decretos los declaran hábiles para efectos tributarios.
- Para el procedimiento administrativo, el TUO de la Ley 27444 (art. 145.1) excluye del cómputo los días "no laborables del servicio".
Por eso el paquete los distingue de los feriados:
Por defecto, cortan los plazos, como en la Ley 27444. Para un plazo tributario o del sector privado, cuéntalos como hábiles:
o en toda la aplicación, con 'no_laborables_inhabiles' => false en la
configuración.
El paquete trae los de alcance nacional desde 2025:
| Fecha | Norma |
|---|---|
| 2 may 2025, 26 dic 2025, 2 ene 2026 | D.S. 042-2025-PCM |
| 27 jul 2026 | D.S. 075-2026-PCM |
Agregar los que se declaren después
No hace falta esperar una versión nueva. Publica la configuración y agrégalos en
extraordinarios:
tipo es no_laborable (sector público, compensable), extraordinario (un
feriado para todos, por una sola vez) o regional (un feriado solo donde opera
tu aplicación, por una sola vez). Si coincide con un feriado, gana el
feriado. Una fecha o un tipo mal escritos lanzan una excepción al arrancar.
Ajustar el calendario
Cada aplicación puede adaptar el catálogo a su realidad desde
config/feriados-peru.php, sin esperar una versión nueva.
Feriados regionales o locales
El paquete solo trae los nacionales. Los de tu región o entidad que se repiten
cada año van en regionales, y cortan los plazos como los nacionales (el art.
145 de la Ley 27444 también excluye los feriados regionales):
Quedan con TipoFeriado::Regional. Para uno de una sola fecha, usa
extraordinarios con 'tipo' => 'regional'.
Omitir feriados
Para no considerar un feriado del paquete, ponlo en omitir, por su clave o
por una fecha puntual:
Las claves son anio_nuevo, jueves_santo, viernes_santo, dia_del_trabajo,
batalla_de_arica, san_pedro_y_san_pablo, fuerza_aerea,
fiestas_patrias_28, fiestas_patrias_29, batalla_de_junin,
santa_rosa_de_lima, combate_de_angamos, todos_los_santos,
inmaculada_concepcion, batalla_de_ayacucho y navidad. Cada Feriado la
trae en $feriado->clave.
Una clave o una fecha mal escritas lanzan una excepción al arrancar, para que un error de tipeo no pase desapercibido.
Sin Laravel, las mismas opciones son argumentos de Calendario::peru():
Desarrollo
Todo corre en Docker con la imagen oficial composer:2, así que no hace falta
tener PHP instalado:
El CI prueba con Laravel 12 y 13, con PHP 8.2 a 8.5, y también con las versiones mínimas de las dependencias.
Los cambios de cada versión están en el CHANGELOG.
Licencia
MIT. Ver LICENSE.md.
All versions of laravel-feriados-peru with dependencies
illuminate/contracts Version ^12.0|^13.0
illuminate/support Version ^12.0|^13.0
nesbot/carbon Version ^3.8
spatie/laravel-package-tools Version ^1.16.2