5.0.5 • Published 3 months ago

@hebcal/triennial v5.0.5

Weekly downloads
-
License
BSD-2-Clause
Repository
github
Last release
3 months ago

@hebcal/triennial

Javascript Triennial Torah Readings

Build Status

“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

Functions

Typedefs

Triennial

Triennial Torah readings

Kind: global class

new Triennial(hebrewYear, il)

Calculates Triennial schedule for entire Hebrew year

ParamTypeDefaultDescription
hebrewYearnumberHebrew Year (default current year)
ilbooleanfalseIsrael (default false)

triennial.getReading(parsha, yearNum) ⇒ TriennialAliyot

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

ParamTypeDescription
parshastringparsha name ("Bereshit" or "Achrei Mot-Kedoshim")
yearNumnumber0 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

ParamTypeDescription
yearnumberHebrew year

Triennial.getCycleStartYear(year) ⇒ number

Returns Hebrew year that this 3-year triennial cycle began

Kind: static method of Triennial

ParamTypeDescription
yearnumberHebrew year

getTriennial(year, il) ⇒ Triennial

Calculates the 3-year readings for a given year

Kind: global function

ParamTypeDefaultDescription
yearnumberHebrew year
ilbooleanfalseIsrael

getTriennialHaftaraForHoliday(key, yearNum) ⇒ Object

Looks up the alternative triennial Haftara for a holiday

Kind: global function

ParamType
keystring
yearNumnumber

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"

ParamTypeDefaultDescription
evEvent
ilbooleanfalseIsrael

writeTriennialCsv(stream, hyear, il)

Kind: global function

ParamTypeDefault
streamfs.WriteStream
hyearnumber
ilbooleanfalse

TriennialAliyot : Object

Represents triennial aliyot for a given date

Kind: global typedef
Properties

NameTypeDescription
aliyotObject.<string, Aliyah>a map of aliyot 1-7 plus "M"
yearNumnumberyear number, 0-2
dateDateShabbat date for when this parsha is read in this 3-year cycle
readSeparatelybooleantrue if a double parsha is read separately in year yearNum
date1DateShabbat date of the first part of a read-separately aliyah pair
date2DateShabbat date of the second part of a read-separately aliyah pair
fullParshabooleantrue if we read the entire parsha
5.0.5

3 months ago

5.0.4

4 months ago

5.0.3

5 months ago

5.0.2

5 months ago

5.0.1

5 months ago

5.0.0

5 months ago

1.3.3

8 months ago

1.4.1

7 months ago

1.4.0

7 months ago

1.3.2

11 months ago

1.3.1

11 months ago

1.3.0

11 months ago

1.2.0

1 year ago

1.1.0

1 year ago

1.0.4

2 years ago

1.0.3

2 years ago

1.0.2

2 years ago

1.0.1

2 years ago

1.0.0

2 years ago