PHP code example of aeunius / laravel-feriados-peru

    
        
<?php
require_once('vendor/autoload.php');

/* Start to develop here. Best regards https://php-download.com/ */

    

aeunius / laravel-feriados-peru example snippets

use Aeunius\FeriadosPeru\Facades\Feriados;

Feriados::esFeriado('2026-07-28');   // true
Feriados::esFeriado('2023-06-07');   // false: el 7 de junio rige desde 2024

Feriados::delAnio(2026);             // Collection de 16 Feriado, en orden

$navidad = Feriados::proximo('2026-12-24');
$navidad->fecha;                     // CarbonImmutable 2026-12-25
$navidad->nombre;                    // 'Navidad'
$navidad->tipo;                      // TipoFeriado::Nacional
$navidad->esMovil();                 // false

Feriados::esDiaHabil('2026-07-28');                       // false

// Notificado el lunes 27 de julio de 2026, un plazo de 5 días hábiles salta
// Fiestas Patrias (28 y 29) y el fin de semana, y termina el 5 de agosto.
Feriados::sumarDiasHabiles('2026-07-27', 5);              // CarbonImmutable 2026-08-05
Feriados::diasHabilesEntre('2026-07-27', '2026-08-05');   // 5
Feriados::esVencido('2026-07-27', 5);                     // ¿hoy ya pasó el 5 de agosto?
Feriados::esVencido('2026-07-27', 5, hoy: '2026-08-05');  // false: el último día aún vale

'fin_de_semana' => [CarbonInterface::SUNDAY],

use Aeunius\FeriadosPeru\Support\Calendario;
use Aeunius\FeriadosPeru\Support\Pascua;
use Carbon\CarbonInterface;

Calendario::peru()->esFeriado('2026-04-03');   // true (Viernes Santo)
Calendario::peru(finDeSemana: [CarbonInterface::SUNDAY])
    ->sumarDiasHabiles('2026-09-11', 1);       // sábado 2026-09-12
Pascua::domingo(2026);                         // CarbonImmutable 2026-04-05

Feriados::esFeriado('2026-07-27');       // false
Feriados::esNoLaborable('2026-07-27');   // true (D.S. 075-2026-PCM)
Feriados::delAnio(2026);                 // 16 feriados
Feriados::delAnio(2026, conNoLaborables: true);   // 18: suma el 2 ene y el 27 jul

Feriados::sumarDiasHabiles('2026-07-24', 1);                                  // 2026-07-30
Feriados::conNoLaborablesInhabiles(false)->sumarDiasHabiles('2026-07-24', 1);  // 2026-07-27

'extraordinarios' => [
    ['fecha' => '2026-12-24', 'nombre' => 'Día no laborable', 'tipo' => 'no_laborable', 'norma' => 'D.S. 999-2026-PCM'],
    ['fecha' => '2026-10-15', 'nombre' => 'Feriado por ley', 'tipo' => 'extraordinario'],
],

'regionales' => [
    ['mes' => 9, 'dia' => 24, 'nombre' => 'Virgen de las Mercedes'],
    ['mes' => 1, 'dia' => 18, 'nombre' => 'Aniversario de Lima', 'desde' => 2027],
],

'omitir' => [
    'fuerza_aerea',   // en todos los años
    '2026-07-27',     // solo ese día: tu entidad trabajó el no laborable
],

Calendario::peru(
    regionales: [['mes' => 9, 'dia' => 24, 'nombre' => 'Virgen de las Mercedes']],
    omitir: ['fuerza_aerea'],
);

bash
php artisan vendor:publish --tag=feriados-peru-config