Programación

PHP

Funciones para obtener fechas de semana santa por año

Última actualización: 15-09-2024 14:35

• Fecha del "Domingo de Resurrección" del año solicitado.
• Arreglo con fechas de la semana santa del año solicitado.
• Arreglo con fechas de la semana santa del año solicitado agrupando por año.
• Arreglo con fechas de la semana santa del rango de años solicitado.
• Arreglo con fechas de la semana santa del rango de años solicitado en grupos por año.
• HTML de una tabla con el listado de fechas por año del rango que se solicite.

• Esta clase se basa en la utilización de la función easter_days de PHP.'
  (La función easter_date ponía como límite el año 2037 en versiones de 32 bits de servidores de publicación...
• No se han incluido verificaciones de validez de parámetros de las funciones.

<?php
    // :: Funciones comunes para otras clases ::
    class cl_common {
        // Devuelve HTML de legibilidad facilitada de un arreglo
        function showArray($ar) {
            return '<pre style="padding:10px; background-color:#ccc;">' . print_r($ar, true) . '</pre>';
        }
    }
 
    // :: Cálculo de fechas de semana santa a partir de la función easter_days de PHP ::
    class cl_holyWeek extends cl_common {
 
        // Devuelve la fecha del "Domingo de Resurrección" del año solicitado
        function getLastDateOfYear($year = 0) {
            if ($year == 0) $year = date('Y');
            $easterDays = easter_days($year);
            $dt =  new DateTime(date('Y-m-d', strtotime($year . '-03-21')));
            $dt->add(new DateInterval('P' . $easterDays . 'D'));
            return $dt->format('Y-m-d');
        }
 
        // Devuelve arreglo con fechas de la semana santa del año solicitado
        function getDatesOfYear($year = 0) {
            if ($year == 0) $year = date('Y');
            $r = NULL;
            $diff1Day = new DateInterval('P1D');
            $diff1Day->invert = 1;
 
            $easterDays = easter_days($year);
 
            $dt =  new DateTime(date('Y-m-d', strtotime($year . '-03-21')));
            $dt->add(new DateInterval('P' . $easterDays . 'D'));
 
            $r =  array($dt->format('Y-m-d'));
            for ($i = 1; $i <= 3; $i++) {
                $dt->add($diff1Day);
                $r[] = $dt->format('Y-m-d');
            }
 
            return array_reverse($r);
        }
 
        // Devuelve arreglo con fechas de la semana santa del año solicitado agrupando por año
        function getDatesOfYearLikeGroup($year = 0) {
            $tmp = $this->getDatesOfYear($year);
            $starterYear = intval(substr($tmp[0], 0, 4));
            $r[$starterYear] = $tmp;
            return $r;
        }
 
        // Devuelve arreglo con fechas de la semana santa del rango de años solicitado
        function getDatesOfYears($starterYear = 0, $endingYear = 0) {
            $r = $this->getDatesOfYear($starterYear);
 
            $endingYear = ($endingYear <= 0 ? $starterYear : $endingYear);
 
            for ($i = $starterYear + 1; $i <= $endingYear; $i++)
                $r = array_merge($r, $this->getDatesOfYear($i));
 
            return $r;
        }
 
        // Devuelve arreglo con fechas de la semana santa del rango de años solicitado en grupos por año
        function getDateGroupsOfYears($starterYear = 0, $endingYear = 0) {
            if ($starterYear == 0) $starterYear = date('Y');
 
            $r = null;
 
            for ($i = $starterYear; $i <= $endingYear; $i++)
                $r[$i] = $this->getDatesOfYear($i);
 
            return $r;
        }
 
        // Devuelve el HTML de una tabla con el  listado de fechas por año del rango que se solicite
        function getHTMLResult($starterYear = 0, $endingYear = 0) {
            $r = '';
            $ar = $this->getDateGroupsOfYears($starterYear, $endingYear);
 
            $theadAndYearTD_Style = ' style="background-color: black; color:white;"';
            $oddRow = '';
            $evenRow = ' style="background-color:#eaeaea;"';
 
            $tID = 'tResultHolidayDates-' . md5(rand(1, 1000));
 
            $r .= '<style>'
                    . '#' . $tID . ' tbody tr:hover { background-color:#363636!important; color:white!important; }'
                    . '.tr-current-year { color:#006600; background-color:#7d7!important; font-weight:bold; }'
                    . '#' . $tID . ' .tr-current-year:hover { color:#007!important; background-color:#FC0!important;  }'
                . '</style>';
            $r .= '<table'
                        . ' id="' . $tID
                        . '" name="' . $tID . '"'
                        . ' style="width:100%; font-family:Verdana; text-align: center; border-collapse: collapse;"'
                        . ' cellpadding="10" border="1"'
                    . '>'
                        . '<thead' . $theadAndYearTD_Style . '>'
                            . '<tr>'
                                . '<th>Año</th>'
                                . '<th>Jueves Santo</th>'
                                . '<th>Viernes Santo</th>'
                                . '<th>Sábado de Gloria</th>'
                                . '<th>Domingo de Resurrección</th>'
                            . '</tr>'
                        . '</thead>'
                        . '<tbody>';
                            $nrow = 0;
                            $currentYear = intval(date('Y'));
                            foreach ($ar as $year => $arDate) {
                                $nrow++;
                                $r .= '<tr'
                                            . ($year == $currentYear ? ' class="tr-current-year" title="Este es el año en curso actualmente"' : '')
                                            . ($nrow % 2 == 0 ? $evenRow : $oddRow)
                                        . '>';
                                    $r .= '<td' . $theadAndYearTD_Style . '>' . $year . '</td>';
                                    foreach ($arDate as $idx => $xdate) $r .= '<td>' . $xdate . '</td>';
                                $r .= '</tr>';
                            }
                        $r .=  '</tbody>'
                    . '</table>';
 
            return $r;
        }
 
    }
 
    // Declaración de instancia de cl_holyWeek
    $o = new cl_holyWeek();
 
    // Definición de parámetros de año de inicio y año final del rango de consulta
    $currentYear = intval(date('Y'));
    $startYear = $currentYear - 2;
    $endYear = $currentYear + 2;
 
    $sTitleStyle = ' style="background-color:#069; color:#FFF; padding:4px;"';
    $xc = '';
    if (true) $xc .= '<div ' . $sTitleStyle . '>Función [getLastDateOfYear] :: Muestra fecha del Domingo de Resurrección del año en curso</div>'
                    . '<div style="padding: 10px; background-color:#ccc;">' . $o->getLastDateOfYear() . '</div>'
                    . '<hr/>';
 
    if (true) $xc .= '<div ' . $sTitleStyle . '>' . 'Función [getDatesOfYear] :: Devuelve arreglo con fechas de la semana santa del año solicitado' . '</div>'
                    . $o->showArray($o->getDatesOfYear()) . '<hr/>';
 
    if (true) $xc .= '<div ' . $sTitleStyle . '>' . 'Función [getDatesOfYearLikeGroup] :: Devuelve arreglo con fechas de la semana santa del año solicitado agrupando por año' . '</div>'
                    . $o->showArray($o->getDatesOfYearLikeGroup()) . '<hr/>';
 
    if (true) $xc .= '<div ' . $sTitleStyle . '>' . 'Función [getDatesOfYears] :: Devuelve arreglo con fechas de la semana santa del rango de años solicitado' . '</div>'
                    . $o->showArray($o->getDatesOfYears($startYear, $endYear)) . '<hr/>';
 
    if (true) $xc .= '<div ' . $sTitleStyle . '>' . 'Función [getDateGroupsOfYears] :: Devuelve arreglo con fechas de la semana santa del rango de años solicitado en grupos por año' . '</div>'
                    . $o->showArray($o->getDateGroupsOfYears($startYear, $endYear)) . '<hr/>';
 
    // Definición de parámetros de año de inicio y año final del rango de consulta
    $startYear = 1979;
    $endYear = 2040;
    if (true) $xc .= '<div ' . $sTitleStyle . '>' . 'Función [getHTMLResult] :: Devuelve el HTML de una tabla con el  listado de fechas por año del rango que se solicite' . '</div>'
                    . '<br/>'
                    . $o->getHTMLResult($startYear, $endYear);
 
    echo $xc;
?>

Resultado

Array
(
    [0] => 2024-03-28
    [1] => 2024-03-29
    [2] => 2024-03-30
    [3] => 2024-03-31
)

Array
(
    [2024] => Array
        (
            [0] => 2024-03-28
            [1] => 2024-03-29
            [2] => 2024-03-30
            [3] => 2024-03-31
        )

)

Array
(
    [0] => 2022-04-14
    [1] => 2022-04-15
    [2] => 2022-04-16
    [3] => 2022-04-17
    [4] => 2023-04-06
    [5] => 2023-04-07
    [6] => 2023-04-08
    [7] => 2023-04-09
    [8] => 2024-03-28
    [9] => 2024-03-29
    [10] => 2024-03-30
    [11] => 2024-03-31
    [12] => 2025-04-17
    [13] => 2025-04-18
    [14] => 2025-04-19
    [15] => 2025-04-20
    [16] => 2026-04-02
    [17] => 2026-04-03
    [18] => 2026-04-04
    [19] => 2026-04-05
)

Array
(
    [2022] => Array
        (
            [0] => 2022-04-14
            [1] => 2022-04-15
            [2] => 2022-04-16
            [3] => 2022-04-17
        )

    [2023] => Array
        (
            [0] => 2023-04-06
            [1] => 2023-04-07
            [2] => 2023-04-08
            [3] => 2023-04-09
        )

    [2024] => Array
        (
            [0] => 2024-03-28
            [1] => 2024-03-29
            [2] => 2024-03-30
            [3] => 2024-03-31
        )

    [2025] => Array
        (
            [0] => 2025-04-17
            [1] => 2025-04-18
            [2] => 2025-04-19
            [3] => 2025-04-20
        )

    [2026] => Array
        (
            [0] => 2026-04-02
            [1] => 2026-04-03
            [2] => 2026-04-04
            [3] => 2026-04-05
        )

)