easter_date

(PHP 4, PHP 5, PHP 7, PHP 8)

easter_date — Retorna el timestamp Unix para la medianoche local el día de Pascua de un año dado

Descripción

easter_date(?int $year = null, int $mode = CAL_EASTER_DEFAULT): int

Retorna un timestamp UNIX para Pascua, a medianoche, para un año dado.

La fecha de Pascua fue establecida por el concilio de Nicea, en 325 de nuestra era, como siendo el domingo después de la primera luna llena que sigue al equinoccio de primavera. El equinoccio de primavera es considerado como siendo siempre el 21 de marzo, lo cual reduce el problema al cálculo de la fecha de la luna llena que sigue, y el domingo siguiente. El algoritmo fue introducido hacia 532, por Dionysius Exiguus. Con el calendario Juliano, (para los años antes de 1753), un ciclo de 19 años es suficiente para conocer las fechas de las fases de la luna. Con el calendario Gregoriano, (a partir de los años 1753, diseñado por Clavius y Lilius, luego introducido por el papa Gregorio XIII en octubre de 1582, y en Gran Bretaña y sus colonias en septiembre de 1752), dos factores de corrección fueron añadidos para hacer el ciclo más preciso.

Parámetros

year: El año, debe ser un número comprendido entre 1970 y 2037 para los sistemas de 32 bits, o entre 1970 y 2 000 000 000 para los sistemas de 64 bits. Si se omite o es null, el valor por omisión será el año actual según la hora local.
mode: Permite calcular la fecha de Pascua según el calendario Juliano cuando se define como CAL_EASTER_ALWAYS_JULIAN. Ver también las constantes de calendario.

Valores devueltos

La fecha para Pascua, en forma de timestamp unix.

Errores/Excepciones

Se genera una ValueError si el año es anterior a 1970 o posterior a 2037 al ejecutarse en un sistema de 32 bits, o posterior a 2 000 000 000 en un sistema de 64 bits.

Historial de cambios

Versión	Descripción
8.3.0	En los sistemas de 64 bits, el argumento `year` ahora acepta valores en el rango de 1970 a 2 000 000 000.
8.0.0	`year` ahora es nullable.
8.0.0	Ahora se genera una ValueError cuando `year` está fuera del rango permitido. Anteriormente, se generaba una advertencia `E_WARNING` y la función retornaba `false`.

Ejemplos

Ejemplo #1 Ejemplo con easter_date()

<?php

echo date("M-d-Y", easter_date(1999));        // Apr-04-1999
echo date("M-d-Y", easter_date(2000));        // Apr-23-2000
echo date("M-d-Y", easter_date(2001));        // Apr-15-2001

?>

Ejemplo #2 Uso de easter_date() con DateTime

<?php

$timestamp = easter_date(2023);

$datetime = new \DateTime();
$datetime->setTimestamp($timestamp);

echo $datetime->format('M-d-Y'); // Apr-09-2023

?>

Notas

Nota:
La función easter_date() se basa en las funciones de la biblioteca C time del sistema, en lugar de las funciones date y time internas de PHP. Además, la función easter_date() utiliza la variable de entorno TZ para determinar la zona horaria a utilizar, en lugar de la zona horaria por defecto de PHP, lo cual puede llevar a un comportamiento no deseado al utilizar esta función con otras funciones date de PHP.

Como solución alternativa, puede utilizarse la función easter_days() con las clases DateTime y DateInterval para calcular el día de Pascua en la zona horaria de PHP, de la siguiente manera:
<?php function get_easter_datetime($year) { $base = new DateTime("$year-03-21"); $days = easter_days($year); return $base->add(new DateInterval("P{$days}D")); } foreach (range(2012, 2015) as $year) { printf("Pascua, en %d, cae el %s\n", $year, get_easter_datetime($year)->format('d F')); } ?>

El resultado del ejemplo sería:
Pascua, en 2012, cae el 08 Abril
Pascua, en 2013, cae el 31 Marzo
Pascua, en 2014, cae el 20 Abril
Pascua, en 2015, cae el 05 Abril

Ver también

easter_days() - Retorna el número de días entre el 21 de marzo y Pascua, para un año dado para el cálculo de Pascua antes de 1970 y después de 2037

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 6 notes

down

maxie ¶

17 years ago

To compute the correct Easter date for Eastern Orthodox Churches I made a function based on the Meeus Julian algorithm:



<?php

function orthodox_eastern($year) {

    $a = $year % 4;

    $b = $year % 7;

    $c = $year % 19;

    $d = (19 * $c + 15) % 30;

    $e = (2 * $a + 4 * $b - $d + 34) % 7;

    $month = floor(($d + $e + 114) / 31);

    $day = (($d + $e + 114) % 31) + 1;

    

    $de = mktime(0, 0, 0, $month, $day + 13, $year);

    

    return $de;

}

?>

down

Alexander Bliznyuk ¶

7 years ago

Thank you, @Maxie, for algorythm for computing Orthodox Easter date.
It can be improved though. You added 13 days in order to map Julian calendar to Gregorian.  But 13 days is not a constant. It's an accumulated error fixed in Gregorian and should be calculated with this formula: (int)($year / 100) - (int)($year / 400) - 2

down

py dot lebecq at gmail dot com ¶

15 years ago

I recently had to write a function that allows me to know if today is a holiday.

And in France, we have some holidays which depends on the easter date. Maybe this will be helpful to someone.

Just modify in the $holidays array the actual holidays dates of your country.

<?php
/**
 * This function returns an array of timestamp corresponding to french holidays
 */
protected static function getHolidays($year = null)
{
  if ($year === null)
  {
    $year = intval(date('Y'));
  }
    
  $easterDate  = easter_date($year);
  $easterDay   = date('j', $easterDate);
  $easterMonth = date('n', $easterDate);
  $easterYear   = date('Y', $easterDate);

  $holidays = array(
    // These days have a fixed date
    mktime(0, 0, 0, 1,  1,  $year),  // 1er janvier
    mktime(0, 0, 0, 5,  1,  $year),  // Fête du travail
    mktime(0, 0, 0, 5,  8,  $year),  // Victoire des alliés
    mktime(0, 0, 0, 7,  14, $year),  // Fête nationale
    mktime(0, 0, 0, 8,  15, $year),  // Assomption
    mktime(0, 0, 0, 11, 1,  $year),  // Toussaint
    mktime(0, 0, 0, 11, 11, $year),  // Armistice
    mktime(0, 0, 0, 12, 25, $year),  // Noel

    // These days have a date depending on easter
    mktime(0, 0, 0, $easterMonth, $easterDay + 2,  $easterYear),
    mktime(0, 0, 0, $easterMonth, $easterDay + 40, $easterYear),
    mktime(0, 0, 0, $easterMonth, $easterDay + 50, $easterYear),
  );

  sort($holidays);
  
  return $holidays;
}
?>

down

Guillaume Dufrene ¶

12 years ago

I found a problem with holidays timestamp computation and daylight saving time.
An article about it at http://goo.gl/76t31 (in french only, sorry).

In summary, this year (2013) easter begins before adding an hour for daylight saving time (occured sunday at 3:00). It means that if you do $easter + X, where x is a number of seconds equivalent to one day, 39 days or 50 days, the result is not equals to a midnight timestamp...

Here a function to check if a midnight timestamp is equals to an holiday :

function isHoliday( $ts ) {
// Licence : Creative Commons (BY)
// By Webpulser - http://goo.gl/76t31
  $fixed_holidays = array( ’01-01′, ’01-05′, ’08-05′, ’14-07′, ’15-08′, ’11-11′, ’25-12′ );
  $format = ‘d-m’;

 $dm = date($format, $ts);
  if ( in_array($dm, $fixed_holidays) ) return true;

 $easter = easter_date( date(‘Y’, $ts) );
  if ( date($format, $easter +   86400) == $dm ) return true;
  if ( date($format, $easter + 3369600) == $dm ) return true;
  if ( date($format, $easter + 4320000) == $dm ) return true;

 return false;
}

feel free to use / modify.

down

-1

phpuser ¶

20 years ago

The algorithm from Bigtree is correct if you add some (int) cast
<?php 
   function easter_date ($Year) { 
   
       /* 
       G is the Golden Number-1 
       H is 23-Epact (modulo 30) 
       I is the number of days from 21 March to the Paschal full moon 
       J is the weekday for the Paschal full moon (0=Sunday, 
         1=Monday, etc.) 
       L is the number of days from 21 March to the Sunday on or before 
         the Paschal full moon (a number between -6 and 28) 
       */ 
       

         $G = $Year % 19; 
         $C = (int)($Year / 100); 
         $H = (int)($C - (int)($C / 4) - (int)((8*$C+13) / 25) + 19*$G + 15) % 30; 
         $I = (int)$H - (int)($H / 28)*(1 - (int)($H / 28)*(int)(29 / ($H + 1))*((int)(21 - $G) / 11)); 
         $J = ($Year + (int)($Year/4) + $I + 2 - $C + (int)($C/4)) % 7; 
         $L = $I - $J; 
         $m = 3 + (int)(($L + 40) / 44); 
         $d = $L + 28 - 31 * ((int)($m / 4)); 
         $y = $Year; 
         $E = mktime(0,0,0, $m, $d, $y); 

         return $E; 

   } 
?>

down

-3

adwil at live dot com ¶

11 years ago

Hey, recently I needed a function to get realization dates in online shop, so here it is (ready to go for polish users, please adjust your dates for any other country):

<?php
function getWorkday($date1,$workDays) {
        $workDays = (int)$workDays;
        if ($workDays <= 0)
            return null;

        $date1=strtotime('-1 day',strtotime($date1));

        $lastYear = null;
        $hol=array('01-01','01-06','05-01','05-03','08-15','11-01','11-11','12-25','12-26');  //array of month-date of static holidays (these are from Poland)
        $i = 0;
        while ($i<=$workDays) {
            $year = date('Y', $date1);
            if ($year !== $lastYear){
                $lastYear = $year;
                $easter = date('m-d', easter_date($year));
                $date = strtotime($year . '-' . $easter); // easter
                $easterSec = date('m-d', strtotime('+1 day', $date)); // easter monday
                $greens = date('m-d', strtotime('+49 days', $date)); // zielone swiatki
                $cc = date('m-d', strtotime('+60 days', $date)); // boze cialo
                $hol[] = $easter;
                $hol[] = $easterSec;
                $hol[] = $greens;
                $hol[] = $cc;
            }
            $weekDay=date('w',$date1);
            if (!($weekDay==0 || $weekDay==6 || in_array(date('m-d',$date1),$hol)))
                $i++;

            $date1=strtotime('+1 day',$date1);
        }
        return date('Y-m-d',$date1);
    }
?>

＋add a note