hebcal/hebcal-triennial

Javascript Triennial Torah Readings

@hebcal/triennial

Javascript Triennial Torah Readings

“Many congregations pattern their weekly Torah reading cycle after a system similar to the one used in ancient Israel during the rabbinic period. In this system, the traditional parashiot are each divided into three shorter segments, and the whole Torah is completed once every three years. The system has both advantages and disadvantages, but its ability to shorten the length of Torah reading without sacrificing the complete reading of the Torah on a regular basis has made it the choice of some synagogues in the Conservative Movement.”

A Complete Triennial System for Reading the Torah, Committee on Jewish Law and Standards of the Rabbinical Assembly

Update December 2021: In November 2020, the CJLS modified the triennial cycle for some combined parshiyot to change the reading for year 3 to be the third section of the parashah.

Modification of the Triennial Cycle Readings for Combined Parashot in Certain Years, Rabbi Miles B. Cohen

Update August 2022: Incorporated An Emendation to Richard Eisenberg’s Complete Triennial System for Reading Torah, to Address a Rare Situation, Rabbi Joshua Heller, 2012

Installation

$ npm install @hebcal/triennial

Synopsis

import {HebrewCalendar, HDate, Event} from '@hebcal/core';
import {formatAliyahWithBook} from '@hebcal/leyning';
import {getTriennialForParshaHaShavua} from '@hebcal/triennial';

const events = HebrewCalendar.calendar({sedrot: true, noHolidays: true});
const ev = events.find((ev) => ev.getDesc() == 'Parashat Pinchas');
const triReading = getTriennialForParshaHaShavua(ev);
for (const [num, aliyah] of Object.entries(triReading)) {
  const number = num == 'M' ? 'maftir' : `aliyah ${num}`;
  const str = formatAliyahWithBook(aliyah);
  console.log(`Triennial ${number}: ${str}`);
}

Classes

Triennial

Triennial Torah readings

Functions

getTriennial(year, [il]) ⇒ Triennial

Calculates the 3-year readings for a given year

getTriennialHaftaraForHoliday(key, yearNum) ⇒ Object

Looks up the alternative triennial Haftara for a holiday

getTriennialForParshaHaShavua(ev, [il]) ⇒ TriennialAliyot

Looks up the triennial leyning for this Parashat HaShavua

writeTriennialCsv(stream, hyear, [il])

Typedefs

TriennialAliyot : Object

Represents triennial aliyot for a given date

Triennial

Triennial Torah readings

Kind: global class

• Triennial
  • new Triennial([hebrewYear], [il])
  • instance
    • .getReading(parsha, yearNum) ⇒ TriennialAliyot
    • .getStartYear() ⇒ number
    • .debug() ⇒ string
  • static
    • .getYearNumber(year) ⇒ number
    • .getCycleStartYear(year) ⇒ number

new Triennial([hebrewYear], [il])

Calculates Triennial schedule for entire Hebrew year

Param	Type	Default	Description
[hebrewYear]	number		Hebrew Year (default current year)
[il]	boolean	false	Israel (default false)

triennial.getReading(parsha, yearNum) ⇒ TriennialAliyot

Kind: instance method of Triennial
Returns: TriennialAliyot - result, including a map of aliyot 1-7 plus "M"

Param	Type	Description
parsha	string	parsha name ("Bereshit" or "Achrei Mot-Kedoshim")
yearNum	number	0 through 2 for which year of Triennial cycle

triennial.getStartYear() ⇒ number

Kind: instance method of Triennial

triennial.debug() ⇒ string

Kind: instance method of Triennial

Triennial.getYearNumber(year) ⇒ number

Returns triennial year 1, 2 or 3 based on this Hebrew year

Kind: static method of Triennial

Param	Type	Description
year	number	Hebrew year

Triennial.getCycleStartYear(year) ⇒ number

Returns Hebrew year that this 3-year triennial cycle began

Kind: static method of Triennial

Param	Type	Description
year	number	Hebrew year

getTriennial(year, [il]) ⇒ Triennial

Calculates the 3-year readings for a given year

Kind: global function

Param	Type	Default	Description
year	number		Hebrew year
[il]	boolean	false	Israel

getTriennialHaftaraForHoliday(key, yearNum) ⇒ Object

Looks up the alternative triennial Haftara for a holiday

Kind: global function

Param	Type
key	string
yearNum	number

getTriennialForParshaHaShavua(ev, [il]) ⇒ TriennialAliyot

Looks up the triennial leyning for this Parashat HaShavua

Kind: global function
Returns: TriennialAliyot - a map of aliyot 1-7 plus "M"

Param	Type	Default	Description
ev	Event
[il]	boolean	false	Israel

writeTriennialCsv(stream, hyear, [il])

Kind: global function

Param	Type	Default
stream	fs.WriteStream
hyear	number
[il]	boolean	false

TriennialAliyot : Object

Represents triennial aliyot for a given date

Kind: global typedef
Properties

Name	Type	Description
aliyot	Object.<string, Aliyah>	a map of aliyot 1-7 plus "M"
yearNum	number	year number, 0-2
date	Date	Shabbat date for when this parsha is read in this 3-year cycle
[readSeparately]	boolean	true if a double parsha is read separately in year yearNum
[date1]	Date	Shabbat date of the first part of a read-separately aliyah pair
[date2]	Date	Shabbat date of the second part of a read-separately aliyah pair
[fullParsha]	boolean	true if we read the entire parsha