View on
Jean Forget > DateTime-Event-Easter-1.05 > DateTime::Event::Easter



Annotate this POD


Open  0
View/Report Bugs
Module Version: 1.05   Source  


DateTime::Event::Easter - Returns Easter events for DateTime objects


  use DateTime::Event::Easter;
  $dt = DateTime->new( year   => 2002,
                       month  => 3,
                       day    => 31,
  $easter_sunday = DateTime::Event::Easter->new();

  $previous_easter_sunday = $easter_sunday->previous($dt);
  # Sun, 15 Apr 2001 00:00:00 UTC
  $following_easter_sunday = $easter_sunday->following($dt);
  # Sun, 20 Apr 2003 00:00:00 UTC
  $closest_easter_sunday = $easter_sunday->closest($dt);
  # Sun, 31 Mar 2002 00:00:00 UTC
  $is_easter_sunday = $easter_sunday->is($dt);
  # 1
  $palm_sunday = DateTime::Event::Easter->new(day=>'Palm Sunday');

  $dt2 = DateTime->new( year   => 2006,
                        month  =>    4,
                        day    =>   30,
  $set  = $palm_sunday->as_set (from=>$dt, to=>$dt2, inclusive=>1);
  @list = $palm_sunday->as_list(from=>$dt, to=>$dt2, inclusive=>1);
  # Sun, 13 Apr 2003 00:00:00 UTC
  # Sun, 04 Apr 2004 00:00:00 UTC
  # Sun, 20 Mar 2005 00:00:00 UTC
  # Sun, 09 Apr 2006 00:00:00 UTC
  $datetime_set = $palm_sunday->as_set;
  # A set of every Palm Sunday ever. See C<DateTime::Set> for more information.


The DateTime::Event::Easter module returns Easter events for DateTime objects. From a given datetime, it can tell you the previous, the following and the closest Easter event. The 'is' method will tell you if the given DateTime is an Easter Event.

Easter Events can be Fat Tuesday, Ash Wednesday, Palm Sunday, Maundy Thursday, Good Friday, Black Saturday, Easter Sunday, Ascension, Pentecost and Trinity Sunday. If that's not enough, the module will also accept an offset so you can get the date for Quasimodo (the next sunday after Easter Sunday) by passing 7.


Easter Sunday is the Sunday following the first full moon on or following the Official Vernal Equinox. The Official Vernal Equinox is March 21st. Easter Sunday is never on the full moon. Thus the earliest Easter can be is March 22nd.

In the orthodox world, although they now use the Gregorian Calendar rather than the Julian, they still take the first full moon on or after the Julian March 21st. As the Julian calendar is slowly getting further and further out of sync with the Gregorian, the first full moon after this date can be a completely different one than for the western Easter. This is why the Orthodox churches celebrate Easter later than western churches.


This class accepts the following options to its 'new' constructor:


For all these methods, unless otherwise noted, $dt is a plain vanila DateTime object or a DateTime object from any DateTime::Calendar module that can handle calls to from_object and utc_rd_values (which should be all of them, but there's nothing stopping someone making a bad egg).

This class offers the following methods.


This class does not export any methods by default, however the following exports are supported.




Support for this module, and for all DateTime modules will be given through the DateTime mailing list -

Bugs should be reported through


Rick Measham <>

Co-maintainer Jean Forget <>


Much help from the DateTime mailing list, especially from:

Eugene van der Pijll - who pointed out flaws causing errors on gregorian years with no eastern easter (like 35000) and who came up with a patch to make the module accept any calendar's DateTime object

Dave Rolsky - who picked nits, designed DateTime itself and leads the project

Martin Hasch - who pointed out the posibility of memory leak with an early beta

Joe Orost and Andreas König - for RT tickets about the POD documentation

Frank Wiegand and Slaven Rezic - for patches fixing the POD problems


(c) Copyright 2003, 2004, 2015 Rick Measham and Jean Forget. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself: GNU Public License version 1 or later and Perl Artistic License.

The full text of the license can be found in the LICENSE file included with this module or at and

Here is the summary of GPL:

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, see <> or write to the Free Software Foundation, Inc.,


DateTime, DateTime::Calendar::Julian, perl(1),

syntax highlighting: