Lectionary Class

The Lectionary class calculates the holy days over a calendar year. Here is some code that demonstrates how to use the object:

<?php

$year = gmdate("Y", gmmktime(NULL));
if ( $_GET['year'] ) {
  $year = $_GET['year'];
}

require_once('Lectionary.php');

// This loads the Lectionary.php and makes it available
$lectionary = new Lectionary();

// Returns an associative array containing the key as the date in seconds
// since January 1, 1970 and the value as the day's Lectionary index number.
$l = $lectionary->get_calendar();

// Loop through each date and print it and the day's title and scripture
$page->content .= "<h2> Lectionary for ".$year."</h2>n";
foreach ( $l as $key => $val) {
  $page->content .= '<h3>'.$lectionary->get_title($key,$val).' (Year '.$lectionary->get_cycle($key).")</h3>n";
  $page->content .= "</p>n";
  $page->content .= '<b>Date:</b> '.$lectionary->get_long_date($key)."<br />n";
  $page->content .= '<b>Old Testament:</b> <a href="../bible/?verse=' .
                    urlencode($lectionary->get_scripture($key,$val,'old')) . '">' .
                    $lectionary->get_scripture($key,$val,'old')    . "</a><br />n";
  $page->content .= '<b>Psalms:</b>        <a href="../bible/?verse=' .
                    urlencode($lectionary->get_scripture($key,$val,'psalms')) .'">'.
                    $lectionary->get_scripture($key,$val,'psalms') . "</a><br />n";
  $page->content .= '<b>New Testament:</b> <a href="../bible/?verse=' .
                    urlencode($lectionary->get_scripture($key,$val,'new'))    .'">'.
                    $lectionary->get_scripture($key,$val,'new')    . "</a><br />n";
  $page->content .= '<b>Gospel:</b>        <a href="../bible/?verse=' .
                    urlencode($lectionary->get_scripture($key,$val,'gospel')) .'">'.
                    $lectionary->get_scripture($key,$val,'gospel') . "</a><br />n";
  $page->content .= "</p>n";
}

?>

Here is how that code looks when it is run:

Lectionary for 2024

Epiphany of the Lord (Year B)

Baptism of the Lord (Year B)

2nd Sunday in Ordinary Time (Year B)

3rd Sunday in Ordinary Time (Year B)

4th Sunday in Ordinary Time (Year B)

5th Sunday in Ordinary Time (Year B)

Transfiguration of the Lord (Year B)

Ash Wednesday (Year B)

1st Sunday in Lent (Year B)

2nd Sunday in Lent (Year B)

3rd Sunday in Lent (Year B)

4th Sunday in Lent (Year B)

5th Sunday in Lent (Year B)

Passion/Palm Sunday (Year B)

Monday of Holy Week (Year B)

Tuesday of Holy Week (Year B)

Wednesday of Holy Week (Year B)

Maundy Thursday (Year B)

Good Friday (Year B)

Easter Vigil (Year B)

Resurrection of the Lord (Year B)

Easter Evening (Year B)

2nd Sunday of Easter (Year B)

3rd Sunday of Easter (Year B)

4th Sunday of Easter (Year B)

5th Sunday of Easter (Year B)

6th Sunday of Easter (Year B)

Ascension of the Lord (Year B)

7th Sunday of Easter (Year B)

Day of Pentecost (Year B)

Trinity Sunday (Year B)

9th Sunday in Ordinary Time (Year B)

10th Sunday in Ordinary Time (Year B)

11th Sunday in Ordinary Time (Year B)

12th Sunday in Ordinary Time (Year B)

13th Sunday in Ordinary Time (Year B)

14th Sunday in Ordinary Time (Year B)

15th Sunday in Ordinary Time (Year B)

16th Sunday in Ordinary Time (Year B)

17th Sunday in Ordinary Time (Year B)

18th Sunday in Ordinary Time (Year B)

19th Sunday in Ordinary Time (Year B)

20th Sunday in Ordinary Time (Year B)

21st Sunday in Ordinary Time (Year B)

22nd Sunday in Ordinary Time (Year B)

23rd Sunday in Ordinary Time (Year B)

24th Sunday in Ordinary Time (Year B)

25th Sunday in Ordinary Time (Year B)

26th Sunday in Ordinary Time (Year B)

27th Sunday in Ordinary Time (Year B)

28th Sunday in Ordinary Time (Year B)

29th Sunday in Ordinary Time (Year B)

30th Sunday in Ordinary Time (Year B)

All Saints' Day (Year B)

31st Sunday in Ordinary Time (Year B)

32nd Sunday in Ordinary Time (Year B)

33rd Sunday in Ordinary Time (Year B)

Christ the King (Year B)

1st Sunday of Advent (Year C)

2nd Sunday of Advent (Year C)

3rd Sunday of Advent (Year C)

4th Sunday of Advent (Year C)

Christmas Eve (Year C)

Christmas Day - Dawn (Year C)

Christmas Day (Year C)

1st Sunday after Christmas Day (Year C)

Here is the Lectionary object source code. It may run out to the right a bit.

<?php
/*
##################################################
#
# Filename..........: $RCSfile: Lectionary.php,v $
# Original Author...: Anthony L. Awtrey
# Version...........: $Revision: 0.1 $
# Last Modified By..: $Author: aawtrey $
# Last Modified.....: $Date: 2006/09/21 18:15:56 $
#
# Copyright 2006 Anthony Awtrey
#
# 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 2 of the License, 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, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#
*/

/*
 * This class uses date calculations to generate the lectionary dates for a
 * given year.
 */
class Lectionary {

  var $year;                   # four digit year
  var $cycle;                  # A, B, or C lectionary cycle
  var $first_sunday;           # Unix timestamp
  var $easter_sunday;          # Unix timestamp
  var $advent_sunday;          # Unix timestamp
  var $sunday_after_epiphany;  # Unix timestamp
  var $calendar;               # Array of dates and data
  var $lectionary;             # XML of lectionary

  /*
   * Class initialization
   */
  function  __construct($year='') {
    global $_SERVER;
    global $_SESSION;
    global $_REQUEST;
    global $_POST;
    global $_GET;
    $this->set_year($year);
  }

  function __destruct()
  {
  }

  /*
   * Sets the year or the current year if nothing is passed
   */
  function set_year($year='') {
    if ( $year == '' ) {
      $this->year = gmstrftime("%Y", gmmktime(time()));
    } else {
      $this->year = $year;
    }
    // Define the key annual dates
    $this->set_first_sunday();
    $this->set_easter_sunday();
    $this->set_advent_sunday();
    $this->set_sunday_after_epiphany();
    $this->load_lectionary();
    $this->generate_calendar();
  }

  /*
   * Load the lectionary from XML
   */
  function load_lectionary() {
    if ( is_file(constant("RELPATH").'include/lectionary.xml') ) {
      $this->lectionary = simplexml_load_file(constant("RELPATH").'include/lectionary.xml');
      return(true);
    } else {
      $this->lectionary = false;
      return(false);
    }
  }

  /*
   * Set the timestamp for the first sunday of the year
   */
  function set_first_sunday() {
    $dow  = intval(gmstrftime("%w", gmmktime(11,0,0,1,1,intval($this->year))));
    if ( $dow == 0 ) { $dow = 7; }
    $delta = 7 - $dow;
    $this->first_sunday = intval(gmmktime(11,0,0,1,1+$delta,intval($this->year)));
  }

  /*
   * Set the timestamp for Easter in a given year
   */
  function set_easter_sunday() {
    $this->easter_sunday = intval(gmmktime(11,0,0,3,21+easter_days(intval($this->year)),intval($this->year)));
  }

  /*
   * Set the timestamp for the first Sunday in advent
   */
  function set_advent_sunday() {
    $dow  = intval(gmstrftime("%w", gmmktime(11,0,0,12,25,intval($this->year))));
    if ( $dow == 0 ) { $dow = 7; }
    $delta = -28 + ( 7 - $dow );
    $this->advent_sunday = intval(gmmktime(11,0,0,12,25+$delta,intval($this->year)));
  }

  /*
   * Set the timestamp for the first sunday after Epiphany (Jan 6)
   */
  function set_sunday_after_epiphany() {
    $dow  = intval(gmstrftime("%w", gmmktime(11,0,0,1,6,intval($this->year))));
    if ( $dow == 0 ) {
      $delta = 7;
    } else {
      $delta = 7 - $dow;
    }
    $this->sunday_after_epiphany = intval(gmmktime(11,0,0,1,6+$delta,intval($this->year)));
  }

  /*
   * Calculate all the calendar dates
   */
  function generate_calendar() {
    $day  = 86400; # Number of seconds in a day

    ##
    ## These are the fixed days in the year
    ##

    if ( $this->first_sunday == gmmktime(11,0,0,1,1,intval($this->year)) ) {
      $this->calendar[$this->first_sunday]                           = '8';  # First Sunday after Christmas Day
    } else {
      $this->calendar[$this->first_sunday]                           = '9';  # Second Sunday after Christmas Day
    }
    $this->calendar[gmmktime(11,0,0,1,6,intval($this->year))]        = '10'; # Epiphany of the Lord
    $this->calendar[$this->sunday_after_epiphany]                    = '11'; # Baptism of the Lord
    $this->calendar[$this->easter_sunday-(49*$day)]                  = '12'; # Transfiguration Sunday
    $this->calendar[$this->easter_sunday-(46*$day)]                  = '13'; # Ash Wednesday
    $this->calendar[$this->easter_sunday-(42*$day)]                  = '14'; # First Sunday in Lent
    $this->calendar[$this->easter_sunday-(35*$day)]                  = '15'; # Second Sunday in Lent
    $this->calendar[$this->easter_sunday-(28*$day)]                  = '16'; # Third Sunday in Lent
    $this->calendar[$this->easter_sunday-(21*$day)]                  = '17'; # Fourth Sunday in Lent
    $this->calendar[$this->easter_sunday-(14*$day)]                  = '18'; # Fifth Sunday in Lent
    $this->calendar[$this->easter_sunday-(7*$day)]                   = '19'; # Palm/Passion Sunday
    $this->calendar[$this->easter_sunday-(6*$day)]                   = '20'; # Monday of Holy Week
    $this->calendar[$this->easter_sunday-(5*$day)]                   = '21'; # Tuesday of Holy Week
    $this->calendar[$this->easter_sunday-(4*$day)]                   = '22'; # Wednesday of Holy Week
    $this->calendar[$this->easter_sunday-(3*$day)]                   = '23'; # Maundy Thursday
    $this->calendar[$this->easter_sunday-(2*$day)]                   = '24'; # Good Friday
    $this->calendar[$this->easter_sunday-(1*$day)]                   = '25'; # Holy Saturday
    $this->calendar[$this->easter_sunday]                            = '26'; # Easter Sunday
    $this->calendar[$this->easter_sunday+(8*60*60)]                  = '27'; # Easter Evening
    $this->calendar[$this->easter_sunday+(7*$day)]                   = '28'; # Second Sunday of Easter
    $this->calendar[$this->easter_sunday+(14*$day)]                  = '29'; # Third Sunday of Easter
    $this->calendar[$this->easter_sunday+(21*$day)]                  = '30'; # Fourth Sunday of Easter
    $this->calendar[$this->easter_sunday+(28*$day)]                  = '31'; # Fifth Sunday of Easter
    $this->calendar[$this->easter_sunday+(35*$day)]                  = '32'; # Sixth Sunday of Easter
    $this->calendar[$this->easter_sunday+(39*$day)]                  = '33'; # Ascension Sunday
    $this->calendar[$this->easter_sunday+(42*$day)]                  = '34'; # Seventh Sunday of Easter
    $this->calendar[$this->easter_sunday+(49*$day)]                  = '35'; # Day of Pentecost
    $this->calendar[$this->easter_sunday+(56*$day)]                  = '36'; # Trinity Sunday
    $this->calendar[gmmktime(8, 0, 0, 11, 1, intval($this->year))]   = '37'; # All Saint's Day
    $this->calendar[$this->advent_sunday-(7*$day)]                   = '38'; # Christ the King Sunday
    $this->calendar[$this->advent_sunday]                            = '1';  # First Sunday in Advent
    $this->calendar[$this->advent_sunday+(7*$day)]                   = '2';  # Second Sunday in Advent
    $this->calendar[$this->advent_sunday+(14*$day)]                  = '3';  # Third Sunday in Advent
    $this->calendar[$this->advent_sunday+(21*$day)]                  = '4';  # Fourth Sunday in Advent
    $this->calendar[gmmktime(21, 0, 0, 12, 24, intval($this->year))] = '5';  # Christmas Eve
    $this->calendar[gmmktime(8, 0, 0, 12, 25, intval($this->year))]  = '6';  # Christmas Day (Sunrise)
    $this->calendar[gmmktime(11, 0, 0, 12, 25, intval($this->year))] = '7';  # Christmas Day
    if ( 0 != intval(gmstrftime("%w", gmmktime(11,0,0,12,25,intval($this->year)))) ) {
      $this->calendar[$this->advent_sunday+(28*$day)]                = '8';  # First Sunday after Christmas Day
    }

    ##
    ## These are the variable days in the year
    ##

    # Variable Sundays after Epiphany counting forward from 2nd Sunday in Ordinary Time
    $index=39;
    for ( $i=$this->sunday_after_epiphany+(7*$day); $i<$this->easter_sunday-(49*$day); $i=$i+(7*$day) ) {
      if ( $this->calendar[$i] == '' ) {
        $this->calendar[$i] = $index; # Sundays after Epiphany
        $index++;
      }
    }

    # Variable Sundays after Pentecost counting backwards from 33rd sunday in Ordinary Time
    $index=70;
    for ( $i=$this->advent_sunday-(14*$day); $i>$this->easter_sunday+(56*$day); $i=$i-(7*$day) ) {
      if ( $this->calendar[$i] == '' ) {
        $this->calendar[$i] = $index; # Sundays after Pentecost
        $index--;
      }
    }

    ksort($this->calendar);
  }

  /*
   * Get the calendar array
   */
  function get_calendar()
  {
    return($this->calendar);
  }

  /*
   * Get the long format date for a given unix timestamp
   */
  function get_long_date($unixdate) {
    $s = get_day_suffix(intval(gmstrftime("%d",$unixdate)));
    return gmstrftime("%A, %B %d<sup>$s</sup>, %Y, %H:%M", $unixdate );
  }
  
  function get_calendar_day($unixdate)
  {
    $year      = gmstrftime('%Y',$unixdate);
    $month     = gmstrftime('%m',$unixdate);
    $day       = gmstrftime('%d',$unixdate);
    $day_start = gmmktime(0,0,0,intval($month),intval($day),intval($year));
    $day_end   = gmmktime(23,59,59,intval($month),intval($day),intval($year));
    $result    = array();
    foreach ( $this->calendar as $key => $val) {
      if ( $key >= $day_start && $key <= $day_end ) {
        $result[$key] = $val;
      }
    }
    return($result);
  }

  /*
   * Get the lectionary cycle for a given date
   */
  function get_cycle($unixdate) {
    $y = array('A','B','C','A');
    $year = gmstrftime("%Y", $unixdate);
    $mod  = ( ($year-1) % 3 );
    if ( $unixdate < $this->advent_sunday ) {
      return($y[$mod]);
    } else {
      return($y[$mod+1]);
    }
  }

  /*
   * Get the title for a given date and index
   */
  function get_title($unixdate,$index) {
    $result = '';
    $xpath   = "//lectionary/year[@name='".$this->get_cycle($unixdate)."']/day[@name='".$index."']/title";
    foreach ( $this->lectionary->xpath($xpath) as $text) {
      $result .= "$text";
    }
    return($result);
  }

  /*
   * Get the scripture for a given date, index, and lesson (old, psalms, new, gospel)
   */
  function get_scripture($unixdate,$index,$lesson) {
    $result = '';
    $xpath   = "//lectionary/year[@name='".$this->get_cycle($unixdate)."']/day[@name='".$index."']/scripture/$lesson";
    foreach ( $this->lectionary->xpath($xpath) as $text) {
      $result .= "$text";
    }
    return($result);
  }

}

?>