Optional
addprint the Hebrew date for the entire date range
Optional
addprint the Hebrew date for dates with some events
Optional
ashkenazi?: booleanuse Ashkenazi transliterations for event titles (default Sephardi transliterations)
Optional
candlelighting?: booleancalculate candle-lighting and havdalah times
Optional
candleminutes before sundown to light candles (default 18)
Optional
dailymap of options to enable daily study calendars
such as dafYomi
, mishnaYomi
, nachYomi
with value true
. For yerushalmi
the value should be a number
for edition (1
for Vilna, 2
for Schottenstein).
Optional
end?: number | HDate | Dateuse specific end date (requires start date)
Optional
fastdegrees for solar depression for end of fast days. Default is 7.083 degrees for 3 medium-sized stars. Other commonly-used values include 6.45 degrees, as calculated by Rabbi Yechiel Michel Tucazinsky.
Optional
havdalahdegrees for solar depression for Havdalah.
Default is 8.5 degrees for 3 small stars. use 7.083 degrees for 3 medium-sized stars
(observed by Dr. Baruch (Berthold) Cohn in his luach published in France in 1899).
If 0
, Havdalah times are suppressed.
Optional
havdalahminutes after sundown for Havdalah (typical values are 42, 50, or 72).
If undefined
(the default), calculate Havdalah according to Tzeit Hakochavim -
Nightfall (the point when 3 small stars are observable in the night time sky with
the naked eye). If 0
, Havdalah times are suppressed.
Optional
hour12?: booleanWhether to use 12-hour time (as opposed to 24-hour time).
Possible values are true
and false
; the default is locale dependent.
Optional
il?: booleanIsraeli holiday and sedra schedule
Optional
isto interpret year as Hebrew year
Optional
locale?: stringtranslate event titles according to a locale
Default value is en
, also built-in are he
and ashkenazi
.
Additional locales (such as ru
or fr
) are provided by the
@hebcal/locales package
Optional
location?: Locationlatitude/longitude/tzid used for candle-lighting
Optional
mask?: numberuse bitmask from flags
to filter events
Optional
molad?: booleaninclude event announcing the molad
Optional
month?: number | stringGregorian or Hebrew month (to filter results to a single month)
Optional
nosuppress regular holidays
Optional
nosuppress minor fasts
Optional
nosuppress modern holidays
Optional
nosuppress Rosh Chodesh
Optional
nosuppress Special Shabbat
Optional
numgenerate calendar for multiple years (default 1)
Optional
omer?: booleaninclude Days of the Omer
Optional
sedrot?: booleancalculate parashah hashavua on Saturdays
Optional
shabbatadd Shabbat Mevarchim
Optional
start?: number | HDate | Dateuse specific start date (requires end date)
Optional
useuse elevation for calculations (default false
).
If true
, use elevation to affect the calculation of all sunrise/sunset based zmanim.
Note: there are some zmanim such as degree-based zmanim that are driven by the amount
of light in the sky and are not impacted by elevation.
These zmanim intentionally do not support elevation adjustment.
Optional
year?: numberGregorian or Hebrew year
Optional
yominclude Yom Kippur Katan (default false
).
יוֹם כִּפּוּר קָטָן is a minor day of atonement occurring monthly on the day preceeding each Rosh Chodesh.
Yom Kippur Katan is omitted in Elul (on the day before Rosh Hashanah),
Tishrei (Yom Kippur has just passed), Kislev (due to Chanukah)
and Nisan (fasting not permitted during Nisan).
When Rosh Chodesh occurs on Shabbat or Sunday, Yom Kippur Katan is observed on the preceding Thursday.
See Wikipedia Yom Kippur Katan practices
Options to configure which events are returned