README
1NAME
2 Date::Easter - Calculates Easter for any given year
3
4SYNOPSIS
5 use Date::Easter;
6 ($month, $day) = julian_easter(1752);
7 ($month, $day) = easter(1753);
8 ($month, $day) = gregorian_easter(1753);
9 ($month, $day) = orthodox_easter(1823);
10
11DESCRIPTION
12 Calculates Easter for a given year.
13
14 easter() is simply an alias to gregorian_easter(), since that's what
15 almost every country in the world currently uses.
16
17 Date::Easter provides the following functions:
18
19 julian_easter
20 ( $month, $day ) = julian_easter( $year );
21
22 Returns the month and day of easter in the given year, in the Julian
23 calendar.
24
25 gregorian_easter
26 ( $month, $day ) = gregorian_easter( $year );
27
28 Returns the month and day of easter in the given year, in the Gregorian
29 calendar, which is what most of the world uses.
30
31 easter
32 ( $month, $day ) = easter( $year );
33
34 Returns the month and day of easter in the given year, in the Gregorian
35 calendar, which is what most of the world uses.
36
37 orthodox_easter
38 ( $month, $day ) = orthodox_easter( $year );
39
40 Returns the month and day of easter in the given year, in the Orthodox
41 calendar.
42
43 From code by Pascalis Ligdas, based on original code by Apostolos
44 Syropoulos
45
46AUTHOR
47 Rich Bowen <rbowen@rcbowen.com>
48
49To Do
50 The use of localtime and timelocal locks us into the epoch, which is a
51 rather silly limitation. Need to move to Date::DayOfWeek or other module
52 to calculate the day of the week. This should immediately make the
53 module usable back to the beginning of celebration of Easter.
54
55Other Comments
56 Note that Date::Manip also has code to do this, and you should
57 probably use that module instead. This module was written as an
58 academic exercise, since I an intrigued by calendrical calculations.
59 On the other hand, Date::Manip is huge, so you might want to use
60 this for that consideration. YMMV.
61
62 See also http://www.pauahtun.org/CalendarFAQ/cal/node3.html for more
63 details on calculating Easter.
64
65 And many thanks to Simon Cozens who provided me with the code for the
66 orthodox_easter function.
67
68 The tests are taken from a table at
69 http://www.chariot.net.au/~gmarts/eastcalc.htm
70
71 The script 'easter' is just a simple way to find out when easter falls
72 in a given year. Type 'easter' to find easter for this year, and 'easter
73 1983' to find when easter falls in 1983.
74
75