DateTime-Calendar-Liturgical-Christian

 view release on metacpan or  search on metacpan

README  view on Meta::CPAN

README for DateTime::Calendar::Liturgical::Christian

This module will return the name, season, week number and liturgical colour
for any day in the Gregorian calendar. It will eventually support the
liturgical calendars of several churches (hopefully at least Anglican,
Lutheran, Orthodox and Roman Catholic). At present it only knows the
calendar for the Episcopal Church of the USA.

lib/DateTime/Calendar/Liturgical/Christian.pm  view on Meta::CPAN

  }

  # First, figure out the season.
  my ($season, $weekno);

  my $advent_sunday = advent_sunday($y);

  if ($easter_point>-47 && $easter_point<0) {
      $season = 'Lent';
      $weekno = ($easter_point+50)/7;
      # FIXME: The ECUSA calendar seems to indicate that Easter Eve ends
      # Lent *and* begins the Easter season. I'm not sure how. Maybe it's
      # in both? Maybe the daytime is in Lent and the night is in Easter?
  } elsif ($easter_point>=0 && $easter_point<=49) {
      # yes, this is correct: Pentecost itself is in Easter season;
      # Pentecost season actually begins on the day after Pentecost.
      # Its proper name is "The Season After Pentecost".
      $season = 'Easter';
      $weekno = $easter_point/7;
  } elsif ($christmas_point>=$advent_sunday && $christmas_point<=-1) {
      $season = 'Advent';

lib/DateTime/Calendar/Liturgical/Christian.pm  view on Meta::CPAN

        nanosecond => $nanosecs,
    );
}

1;

__END__

=head1 NAME

DateTime::Calendar::Liturgical::Christian - calendar of the church year

=head1 SYNOPSIS

 $dtclc = DateTime::Calendar::Liturgical::Christian->new(
    day=>4,
    month=>6,
    year=>2006);

 print $dtclc->name();    # 'Pentecost'
 print $dtclc->colour();  # 'red'

=head1 DESCRIPTION

This module will return the name, season, week number and liturgical colour
for any day in the Gregorian calendar. It will eventually support the
liturgical calendars of several churches (hopefully at least Anglican,
Lutheran, Orthodox and Roman Catholic). At present it only knows the calendar
for the Episcopal Church of the USA.

If you find bugs, or if you have information on the calendar of another
liturgical church, please do let me know (thomas at thurman dot org dot uk).

=head1 OVERVIEW

Some churches use a special church calendar. Days and seasons within the year
may be either "fasts" (solemn times) or "feasts" (joyful times). The year is
structured around the greatest feast in the calendar, the festival of the
Resurrection of Jesus, known as Easter, and the second greatest feast, the
festival of the Nativity of Jesus, known as Christmas. Before Christmas and
Easter there are solemn fast seasons known as Advent and Lent respectively.
After Christmas comes the feast of Epiphany, and after Easter comes the feast
of Pentecost. These days have the adjacent seasons named after them.

The church's new year falls on Advent Sunday, which occurs around the start of
December. Then follows the four-week fast season of Advent, then comes the
Christmas season, which lasts twelve days; then comes Epiphany, then the
forty days of Lent. Then comes Easter, then the long season of Pentecost

lib/DateTime/Calendar/Liturgical/Christian.pm  view on Meta::CPAN

=head1 CONSTRUCTOR

=over 4

=item new ([ OPTIONS ])

This constructs a DateTime::Calendar::Liturgical::Christian object. It takes
a series of named options. Possible options are:

B<year> (required). The year AD in the Gregorian calendar.

B<month> (required). The month number in the Gregorian calendar. 1 is January.

B<day> (required). The day of the month.

B<tradition> (recommended). The tradition to use. Currently only C<ECUSA> is known.

B<advent_blue>. It is currently popular in ECUSA to colour Advent blue,
instead of purple, which will happen if this option is set to 1.

B<bvm_blue>. Some people mark feasts of the Blessed Virgin Mary, the mother of
Jesus, with blue instead of white. This will happen if this option is set to