@hebcal/core 3.50.4 → 4.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +48 -381
- package/dist/bundle.js +357 -829
- package/dist/bundle.min.js +2 -2
- package/dist/greg0.mjs +1 -1
- package/dist/hdate-bundle.js +21 -7
- package/dist/hdate-bundle.min.js +2 -2
- package/dist/hdate.js +21 -7
- package/dist/hdate.mjs +22 -7
- package/dist/hdate0-bundle.js +19 -5
- package/dist/hdate0-bundle.min.js +2 -2
- package/dist/hdate0.mjs +20 -5
- package/dist/index.js +174 -663
- package/dist/index.mjs +174 -654
- package/hebcal.d.ts +17 -102
- package/package.json +9 -9
package/README.md
CHANGED
|
@@ -91,12 +91,6 @@ holidays. <code>@hebcal/core</code> supports four locales by default</p>
|
|
|
91
91
|
<dt><a href="#OmerEvent">OmerEvent</a></dt>
|
|
92
92
|
<dd><p>Represents a day 1-49 of counting the Omer from Pesach to Shavuot</p>
|
|
93
93
|
</dd>
|
|
94
|
-
<dt><a href="#DafYomi">DafYomi</a></dt>
|
|
95
|
-
<dd><p>Returns the Daf Yomi for given date</p>
|
|
96
|
-
</dd>
|
|
97
|
-
<dt><a href="#DafYomiEvent">DafYomiEvent</a></dt>
|
|
98
|
-
<dd><p>Event wrapper around a DafYomi instance</p>
|
|
99
|
-
</dd>
|
|
100
94
|
<dt><a href="#Sedra">Sedra</a></dt>
|
|
101
95
|
<dd><p>Represents Parashah HaShavua for an entire Hebrew year</p>
|
|
102
96
|
</dd>
|
|
@@ -116,22 +110,9 @@ we subclass HolidayEvent to override the <code>url()</code> method.</p>
|
|
|
116
110
|
<dt><a href="#MevarchimChodeshEvent">MevarchimChodeshEvent</a></dt>
|
|
117
111
|
<dd><p>Represents Mevarchim haChodesh, the announcement of the new month</p>
|
|
118
112
|
</dd>
|
|
119
|
-
<dt><a href="#
|
|
120
|
-
<dd><p>
|
|
121
|
-
|
|
122
|
-
</dd>
|
|
123
|
-
<dt><a href="#MishnaYomiEvent">MishnaYomiEvent</a></dt>
|
|
124
|
-
<dd><p>Event wrapper around a Mishna Yomi instance</p>
|
|
125
|
-
</dd>
|
|
126
|
-
<dt><a href="#NachYomiIndex">NachYomiIndex</a></dt>
|
|
127
|
-
<dd><p>A daily regimen of learning the books of Nevi'im (Prophets)
|
|
128
|
-
and Ketuvim (Writings).</p>
|
|
129
|
-
</dd>
|
|
130
|
-
<dt><a href="#NachYomiEvent">NachYomiEvent</a></dt>
|
|
131
|
-
<dd><p>Event wrapper around a Nach Yomi instance</p>
|
|
132
|
-
</dd>
|
|
133
|
-
<dt><a href="#YerushalmiYomiEvent">YerushalmiYomiEvent</a></dt>
|
|
134
|
-
<dd><p>Event wrapper around a Yerushalmi Yomi result</p>
|
|
113
|
+
<dt><a href="#DailyLearning">DailyLearning</a></dt>
|
|
114
|
+
<dd><p>Plug-ins for daily learning calendars such as Daf Yomi, Mishna Yomi, Nach Yomi, etc.</p>
|
|
115
|
+
<p>Learning schedules are provided by the <code>@hebcal/learning</code> package.</p>
|
|
135
116
|
</dd>
|
|
136
117
|
<dt><a href="#HebrewCalendar">HebrewCalendar</a></dt>
|
|
137
118
|
<dd><p>HebrewCalendar is the main interface to the <code>@hebcal/core</code> library.
|
|
@@ -151,12 +132,6 @@ Event names can be rendered in several languges using the <code>locale</code> op
|
|
|
151
132
|
<dd><p>The 54 parshiyot of the Torah as transilterated strings
|
|
152
133
|
parshiot[0] == 'Bereshit', parshiot[1] == 'Noach', parshiot[53] == "Ha'Azinu".</p>
|
|
153
134
|
</dd>
|
|
154
|
-
<dt><a href="#vilna">vilna</a></dt>
|
|
155
|
-
<dd><p>Yerushalmi Yomi configuration for Vilna Edition</p>
|
|
156
|
-
</dd>
|
|
157
|
-
<dt><a href="#schottenstein">schottenstein</a></dt>
|
|
158
|
-
<dd><p>Yerushalmi Yomi configuration for Schottenstein Edition</p>
|
|
159
|
-
</dd>
|
|
160
135
|
</dl>
|
|
161
136
|
|
|
162
137
|
## Functions
|
|
@@ -167,19 +142,6 @@ parshiot[0] == 'Bereshit', parshiot[1] == 'Noach', parshiot[53]
|
|
|
167
142
|
<p>When specifying years of the Hebrew calendar in the present millennium,
|
|
168
143
|
we omit the thousands (which is presently 5 [ה]).</p>
|
|
169
144
|
</dd>
|
|
170
|
-
<dt><a href="#yerushalmiYomi">yerushalmiYomi(date, config)</a> ⇒ <code>any</code></dt>
|
|
171
|
-
<dd><p>Using the Vilna edition, the Yerushalmi Daf Yomi program takes
|
|
172
|
-
~4.25 years or 51 months.
|
|
173
|
-
Unlike the Daf Yomi Bavli cycle, this Yerushalmi cycle skips both
|
|
174
|
-
Yom Kippur and Tisha B'Av (returning <code>null</code>).
|
|
175
|
-
The page numbers are according to the Vilna
|
|
176
|
-
Edition which is used since 1900.</p>
|
|
177
|
-
<p>The Schottenstein edition uses different page numbers and takes
|
|
178
|
-
~6 years to complete.</p>
|
|
179
|
-
<p>Throws an exception if the date is before Daf Yomi Yerushalmi
|
|
180
|
-
cycle began (2 February 1980 for Vilna,
|
|
181
|
-
14 November 2022 for Schottenstein).</p>
|
|
182
|
-
</dd>
|
|
183
145
|
</dl>
|
|
184
146
|
|
|
185
147
|
## Typedefs
|
|
@@ -190,12 +152,6 @@ cycle began (2 February 1980 for Vilna,
|
|
|
190
152
|
<dt><a href="#SedraResult">SedraResult</a> : <code>Object</code></dt>
|
|
191
153
|
<dd><p>Result of Sedra.lookup</p>
|
|
192
154
|
</dd>
|
|
193
|
-
<dt><a href="#MishnaYomi">MishnaYomi</a> : <code>Object</code></dt>
|
|
194
|
-
<dd><p>Describes a mishna to be read</p>
|
|
195
|
-
</dd>
|
|
196
|
-
<dt><a href="#NachYomi">NachYomi</a> : <code>Object</code></dt>
|
|
197
|
-
<dd><p>Describes a chapter to be read</p>
|
|
198
|
-
</dd>
|
|
199
155
|
<dt><a href="#CalOptions">CalOptions</a> : <code>Object</code></dt>
|
|
200
156
|
<dd><p>Options to configure which events are returned</p>
|
|
201
157
|
</dd>
|
|
@@ -260,7 +216,7 @@ Register locale translations.
|
|
|
260
216
|
| Param | Type | Description |
|
|
261
217
|
| --- | --- | --- |
|
|
262
218
|
| locale | <code>string</code> | Locale name (i.e.: `'he'`, `'fr'`) |
|
|
263
|
-
| data | <code>
|
|
219
|
+
| data | <code>LocaleData</code> | parsed data from a `.po` file. |
|
|
264
220
|
|
|
265
221
|
<a name="Locale.useLocale"></a>
|
|
266
222
|
|
|
@@ -848,6 +804,7 @@ Represents an Event with a title, date, and flags
|
|
|
848
804
|
* [.observedIn(il)](#Event+observedIn) ⇒ <code>boolean</code>
|
|
849
805
|
* ~~[.getAttrs()](#Event+getAttrs) ⇒ <code>Object</code>~~
|
|
850
806
|
* [.clone()](#Event+clone) ⇒ [<code>Event</code>](#Event)
|
|
807
|
+
* [.getCategories()](#Event+getCategories) ⇒ <code>Array.<string></code>
|
|
851
808
|
|
|
852
809
|
<a name="new_Event_new"></a>
|
|
853
810
|
|
|
@@ -990,6 +947,12 @@ ev2.observedIn(true); // true
|
|
|
990
947
|
### event.clone() ⇒ [<code>Event</code>](#Event)
|
|
991
948
|
Makes a clone of this Event object
|
|
992
949
|
|
|
950
|
+
**Kind**: instance method of [<code>Event</code>](#Event)
|
|
951
|
+
<a name="Event+getCategories"></a>
|
|
952
|
+
|
|
953
|
+
### event.getCategories() ⇒ <code>Array.<string></code>
|
|
954
|
+
Returns a list of event categories
|
|
955
|
+
|
|
993
956
|
**Kind**: instance method of [<code>Event</code>](#Event)
|
|
994
957
|
<a name="HebrewDateEvent"></a>
|
|
995
958
|
|
|
@@ -1580,6 +1543,7 @@ An event that has an `eventTime` and `eventTimeStr`
|
|
|
1580
1543
|
* [new TimedEvent(date, desc, mask, eventTime, location, linkedEvent)](#new_TimedEvent_new)
|
|
1581
1544
|
* [.render([locale])](#TimedEvent+render) ⇒ <code>string</code>
|
|
1582
1545
|
* [.renderBrief([locale])](#TimedEvent+renderBrief) ⇒ <code>string</code>
|
|
1546
|
+
* [.getCategories()](#TimedEvent+getCategories) ⇒ <code>Array.<string></code>
|
|
1583
1547
|
|
|
1584
1548
|
<a name="new_TimedEvent_new"></a>
|
|
1585
1549
|
|
|
@@ -1614,6 +1578,10 @@ Returns translation of "Candle lighting" without the time.
|
|
|
1614
1578
|
| --- | --- | --- |
|
|
1615
1579
|
| [locale] | <code>string</code> | Optional locale name (defaults to active locale). |
|
|
1616
1580
|
|
|
1581
|
+
<a name="TimedEvent+getCategories"></a>
|
|
1582
|
+
|
|
1583
|
+
### timedEvent.getCategories() ⇒ <code>Array.<string></code>
|
|
1584
|
+
**Kind**: instance method of [<code>TimedEvent</code>](#TimedEvent)
|
|
1617
1585
|
<a name="HavdalahEvent"></a>
|
|
1618
1586
|
|
|
1619
1587
|
## HavdalahEvent
|
|
@@ -1866,97 +1834,6 @@ Returns translation of "Omer day 22" without ordinal numbers.
|
|
|
1866
1834
|
|
|
1867
1835
|
### omerEvent.url() ⇒ <code>string</code>
|
|
1868
1836
|
**Kind**: instance method of [<code>OmerEvent</code>](#OmerEvent)
|
|
1869
|
-
<a name="DafYomi"></a>
|
|
1870
|
-
|
|
1871
|
-
## DafYomi
|
|
1872
|
-
Returns the Daf Yomi for given date
|
|
1873
|
-
|
|
1874
|
-
**Kind**: global class
|
|
1875
|
-
|
|
1876
|
-
* [DafYomi](#DafYomi)
|
|
1877
|
-
* [new DafYomi(date)](#new_DafYomi_new)
|
|
1878
|
-
* [.getBlatt()](#DafYomi+getBlatt) ⇒ <code>number</code>
|
|
1879
|
-
* [.getName()](#DafYomi+getName) ⇒ <code>string</code>
|
|
1880
|
-
* [.render([locale])](#DafYomi+render) ⇒ <code>string</code>
|
|
1881
|
-
|
|
1882
|
-
<a name="new_DafYomi_new"></a>
|
|
1883
|
-
|
|
1884
|
-
### new DafYomi(date)
|
|
1885
|
-
Initializes a daf yomi instance
|
|
1886
|
-
|
|
1887
|
-
|
|
1888
|
-
| Param | Type | Description |
|
|
1889
|
-
| --- | --- | --- |
|
|
1890
|
-
| date | <code>Date</code> \| [<code>HDate</code>](#HDate) \| <code>number</code> | Gregorian or Hebrew date |
|
|
1891
|
-
|
|
1892
|
-
<a name="DafYomi+getBlatt"></a>
|
|
1893
|
-
|
|
1894
|
-
### dafYomi.getBlatt() ⇒ <code>number</code>
|
|
1895
|
-
**Kind**: instance method of [<code>DafYomi</code>](#DafYomi)
|
|
1896
|
-
<a name="DafYomi+getName"></a>
|
|
1897
|
-
|
|
1898
|
-
### dafYomi.getName() ⇒ <code>string</code>
|
|
1899
|
-
**Kind**: instance method of [<code>DafYomi</code>](#DafYomi)
|
|
1900
|
-
<a name="DafYomi+render"></a>
|
|
1901
|
-
|
|
1902
|
-
### dafYomi.render([locale]) ⇒ <code>string</code>
|
|
1903
|
-
Formats (with translation) the dafyomi result as a string like "Pesachim 34"
|
|
1904
|
-
|
|
1905
|
-
**Kind**: instance method of [<code>DafYomi</code>](#DafYomi)
|
|
1906
|
-
|
|
1907
|
-
| Param | Type | Description |
|
|
1908
|
-
| --- | --- | --- |
|
|
1909
|
-
| [locale] | <code>string</code> | Optional locale name (defaults to active locale). |
|
|
1910
|
-
|
|
1911
|
-
<a name="DafYomiEvent"></a>
|
|
1912
|
-
|
|
1913
|
-
## DafYomiEvent
|
|
1914
|
-
Event wrapper around a DafYomi instance
|
|
1915
|
-
|
|
1916
|
-
**Kind**: global class
|
|
1917
|
-
|
|
1918
|
-
* [DafYomiEvent](#DafYomiEvent)
|
|
1919
|
-
* [new DafYomiEvent(date)](#new_DafYomiEvent_new)
|
|
1920
|
-
* [.render([locale])](#DafYomiEvent+render) ⇒ <code>string</code>
|
|
1921
|
-
* [.renderBrief([locale])](#DafYomiEvent+renderBrief) ⇒ <code>string</code>
|
|
1922
|
-
* [.url()](#DafYomiEvent+url) ⇒ <code>string</code>
|
|
1923
|
-
|
|
1924
|
-
<a name="new_DafYomiEvent_new"></a>
|
|
1925
|
-
|
|
1926
|
-
### new DafYomiEvent(date)
|
|
1927
|
-
|
|
1928
|
-
| Param | Type |
|
|
1929
|
-
| --- | --- |
|
|
1930
|
-
| date | [<code>HDate</code>](#HDate) |
|
|
1931
|
-
|
|
1932
|
-
<a name="DafYomiEvent+render"></a>
|
|
1933
|
-
|
|
1934
|
-
### dafYomiEvent.render([locale]) ⇒ <code>string</code>
|
|
1935
|
-
Returns Daf Yomi name including the 'Daf Yomi: ' prefix (e.g. "Daf Yomi: Pesachim 107").
|
|
1936
|
-
|
|
1937
|
-
**Kind**: instance method of [<code>DafYomiEvent</code>](#DafYomiEvent)
|
|
1938
|
-
|
|
1939
|
-
| Param | Type | Description |
|
|
1940
|
-
| --- | --- | --- |
|
|
1941
|
-
| [locale] | <code>string</code> | Optional locale name (defaults to active locale). |
|
|
1942
|
-
|
|
1943
|
-
<a name="DafYomiEvent+renderBrief"></a>
|
|
1944
|
-
|
|
1945
|
-
### dafYomiEvent.renderBrief([locale]) ⇒ <code>string</code>
|
|
1946
|
-
Returns Daf Yomi name without the 'Daf Yomi: ' prefix (e.g. "Pesachim 107").
|
|
1947
|
-
|
|
1948
|
-
**Kind**: instance method of [<code>DafYomiEvent</code>](#DafYomiEvent)
|
|
1949
|
-
|
|
1950
|
-
| Param | Type | Description |
|
|
1951
|
-
| --- | --- | --- |
|
|
1952
|
-
| [locale] | <code>string</code> | Optional locale name (defaults to active locale). |
|
|
1953
|
-
|
|
1954
|
-
<a name="DafYomiEvent+url"></a>
|
|
1955
|
-
|
|
1956
|
-
### dafYomiEvent.url() ⇒ <code>string</code>
|
|
1957
|
-
Returns a link to sefaria.org or dafyomi.org
|
|
1958
|
-
|
|
1959
|
-
**Kind**: instance method of [<code>DafYomiEvent</code>](#DafYomiEvent)
|
|
1960
1837
|
<a name="Sedra"></a>
|
|
1961
1838
|
|
|
1962
1839
|
## Sedra
|
|
@@ -2111,6 +1988,7 @@ Represents a built-in holiday like Pesach, Purim or Tu BiShvat
|
|
|
2111
1988
|
* [.url()](#HolidayEvent+url) ⇒ <code>string</code>
|
|
2112
1989
|
* [.urlDateSuffix()](#HolidayEvent+urlDateSuffix) ⇒ <code>string</code>
|
|
2113
1990
|
* [.getEmoji()](#HolidayEvent+getEmoji) ⇒ <code>string</code>
|
|
1991
|
+
* [.getCategories()](#HolidayEvent+getCategories) ⇒ <code>Array.<string></code>
|
|
2114
1992
|
|
|
2115
1993
|
<a name="new_HolidayEvent_new"></a>
|
|
2116
1994
|
|
|
@@ -2141,6 +2019,10 @@ Constructs Holiday event
|
|
|
2141
2019
|
|
|
2142
2020
|
### holidayEvent.getEmoji() ⇒ <code>string</code>
|
|
2143
2021
|
**Kind**: instance method of [<code>HolidayEvent</code>](#HolidayEvent)
|
|
2022
|
+
<a name="HolidayEvent+getCategories"></a>
|
|
2023
|
+
|
|
2024
|
+
### holidayEvent.getCategories() ⇒ <code>Array.<string></code>
|
|
2025
|
+
**Kind**: instance method of [<code>HolidayEvent</code>](#HolidayEvent)
|
|
2144
2026
|
<a name="RoshChodeshEvent"></a>
|
|
2145
2027
|
|
|
2146
2028
|
## RoshChodeshEvent
|
|
@@ -2250,193 +2132,44 @@ Returns (translated) description of this event
|
|
|
2250
2132
|
| --- | --- | --- |
|
|
2251
2133
|
| [locale] | <code>string</code> | Optional locale name (defaults to active locale). |
|
|
2252
2134
|
|
|
2253
|
-
<a name="
|
|
2254
|
-
|
|
2255
|
-
## MishnaYomiIndex
|
|
2256
|
-
A program of daily learning in which participants study two Mishnahs
|
|
2257
|
-
each day in order to finish the entire Mishnah in ~6 years.
|
|
2258
|
-
|
|
2259
|
-
**Kind**: global class
|
|
2260
|
-
|
|
2261
|
-
* [MishnaYomiIndex](#MishnaYomiIndex)
|
|
2262
|
-
* [new MishnaYomiIndex()](#new_MishnaYomiIndex_new)
|
|
2263
|
-
* [.days](#MishnaYomiIndex+days) : [<code>Array.<MishnaYomi></code>](#MishnaYomi)
|
|
2264
|
-
* [.lookup(date)](#MishnaYomiIndex+lookup) ⇒ [<code>Array.<MishnaYomi></code>](#MishnaYomi)
|
|
2265
|
-
|
|
2266
|
-
<a name="new_MishnaYomiIndex_new"></a>
|
|
2267
|
-
|
|
2268
|
-
### new MishnaYomiIndex()
|
|
2269
|
-
Initializes a Mishna Yomi instance
|
|
2270
|
-
|
|
2271
|
-
<a name="MishnaYomiIndex+days"></a>
|
|
2272
|
-
|
|
2273
|
-
### mishnaYomiIndex.days : [<code>Array.<MishnaYomi></code>](#MishnaYomi)
|
|
2274
|
-
**Kind**: instance property of [<code>MishnaYomiIndex</code>](#MishnaYomiIndex)
|
|
2275
|
-
<a name="MishnaYomiIndex+lookup"></a>
|
|
2276
|
-
|
|
2277
|
-
### mishnaYomiIndex.lookup(date) ⇒ [<code>Array.<MishnaYomi></code>](#MishnaYomi)
|
|
2278
|
-
Looks up a Mishna Yomi
|
|
2279
|
-
|
|
2280
|
-
**Kind**: instance method of [<code>MishnaYomiIndex</code>](#MishnaYomiIndex)
|
|
2281
|
-
|
|
2282
|
-
| Param | Type | Description |
|
|
2283
|
-
| --- | --- | --- |
|
|
2284
|
-
| date | <code>Date</code> \| [<code>HDate</code>](#HDate) \| <code>number</code> | Gregorian date |
|
|
2135
|
+
<a name="DailyLearning"></a>
|
|
2285
2136
|
|
|
2286
|
-
|
|
2137
|
+
## DailyLearning
|
|
2138
|
+
Plug-ins for daily learning calendars such as Daf Yomi, Mishna Yomi, Nach Yomi, etc.
|
|
2287
2139
|
|
|
2288
|
-
|
|
2289
|
-
Event wrapper around a Mishna Yomi instance
|
|
2140
|
+
Learning schedules are provided by the `@hebcal/learning` package.
|
|
2290
2141
|
|
|
2291
2142
|
**Kind**: global class
|
|
2292
2143
|
|
|
2293
|
-
* [
|
|
2294
|
-
* [
|
|
2295
|
-
* [.
|
|
2296
|
-
* [.url()](#MishnaYomiEvent+url) ⇒ <code>string</code>
|
|
2144
|
+
* [DailyLearning](#DailyLearning)
|
|
2145
|
+
* [.addCalendar(name, calendar)](#DailyLearning.addCalendar)
|
|
2146
|
+
* [.lookup(name, hd)](#DailyLearning.lookup) ⇒ [<code>Event</code>](#Event)
|
|
2297
2147
|
|
|
2298
|
-
<a name="
|
|
2148
|
+
<a name="DailyLearning.addCalendar"></a>
|
|
2299
2149
|
|
|
2300
|
-
###
|
|
2301
|
-
|
|
2302
|
-
| Param | Type |
|
|
2303
|
-
| --- | --- |
|
|
2304
|
-
| date | [<code>HDate</code>](#HDate) |
|
|
2305
|
-
| mishnaYomi | [<code>Array.<MishnaYomi></code>](#MishnaYomi) |
|
|
2306
|
-
|
|
2307
|
-
<a name="MishnaYomiEvent+render"></a>
|
|
2308
|
-
|
|
2309
|
-
### mishnaYomiEvent.render([locale]) ⇒ <code>string</code>
|
|
2310
|
-
Returns Mishna Yomi name (e.g. "Bava Metzia 10:5-6" or "Berakhot 9:5-Peah 1:1").
|
|
2311
|
-
|
|
2312
|
-
**Kind**: instance method of [<code>MishnaYomiEvent</code>](#MishnaYomiEvent)
|
|
2313
|
-
|
|
2314
|
-
| Param | Type | Description |
|
|
2315
|
-
| --- | --- | --- |
|
|
2316
|
-
| [locale] | <code>string</code> | Optional locale name (defaults to active locale). |
|
|
2150
|
+
### DailyLearning.addCalendar(name, calendar)
|
|
2151
|
+
Register a new learning calendar.
|
|
2317
2152
|
|
|
2318
|
-
<
|
|
2319
|
-
|
|
2320
|
-
### mishnaYomiEvent.url() ⇒ <code>string</code>
|
|
2321
|
-
Returns a link to sefaria.org
|
|
2322
|
-
|
|
2323
|
-
**Kind**: instance method of [<code>MishnaYomiEvent</code>](#MishnaYomiEvent)
|
|
2324
|
-
<a name="NachYomiIndex"></a>
|
|
2325
|
-
|
|
2326
|
-
## NachYomiIndex
|
|
2327
|
-
A daily regimen of learning the books of Nevi'im (Prophets)
|
|
2328
|
-
and Ketuvim (Writings).
|
|
2329
|
-
|
|
2330
|
-
**Kind**: global class
|
|
2331
|
-
|
|
2332
|
-
* [NachYomiIndex](#NachYomiIndex)
|
|
2333
|
-
* [new NachYomiIndex()](#new_NachYomiIndex_new)
|
|
2334
|
-
* [.lookup(date)](#NachYomiIndex+lookup) ⇒ [<code>NachYomi</code>](#NachYomi)
|
|
2335
|
-
|
|
2336
|
-
<a name="new_NachYomiIndex_new"></a>
|
|
2337
|
-
|
|
2338
|
-
### new NachYomiIndex()
|
|
2339
|
-
Initializes a Nach Yomi instance
|
|
2340
|
-
|
|
2341
|
-
<a name="NachYomiIndex+lookup"></a>
|
|
2342
|
-
|
|
2343
|
-
### nachYomiIndex.lookup(date) ⇒ [<code>NachYomi</code>](#NachYomi)
|
|
2344
|
-
Looks up a Mishna Yomi
|
|
2345
|
-
|
|
2346
|
-
**Kind**: instance method of [<code>NachYomiIndex</code>](#NachYomiIndex)
|
|
2347
|
-
|
|
2348
|
-
| Param | Type | Description |
|
|
2349
|
-
| --- | --- | --- |
|
|
2350
|
-
| date | <code>Date</code> \| [<code>HDate</code>](#HDate) \| <code>number</code> | Gregorian date |
|
|
2351
|
-
|
|
2352
|
-
<a name="NachYomiEvent"></a>
|
|
2353
|
-
|
|
2354
|
-
## NachYomiEvent
|
|
2355
|
-
Event wrapper around a Nach Yomi instance
|
|
2356
|
-
|
|
2357
|
-
**Kind**: global class
|
|
2358
|
-
|
|
2359
|
-
* [NachYomiEvent](#NachYomiEvent)
|
|
2360
|
-
* [new NachYomiEvent(date, nachYomi)](#new_NachYomiEvent_new)
|
|
2361
|
-
* [.render([locale])](#NachYomiEvent+render) ⇒ <code>string</code>
|
|
2362
|
-
* [.url()](#NachYomiEvent+url) ⇒ <code>string</code>
|
|
2363
|
-
|
|
2364
|
-
<a name="new_NachYomiEvent_new"></a>
|
|
2365
|
-
|
|
2366
|
-
### new NachYomiEvent(date, nachYomi)
|
|
2153
|
+
**Kind**: static method of [<code>DailyLearning</code>](#DailyLearning)
|
|
2367
2154
|
|
|
2368
2155
|
| Param | Type |
|
|
2369
2156
|
| --- | --- |
|
|
2370
|
-
|
|
|
2371
|
-
|
|
|
2372
|
-
|
|
2373
|
-
<a name="NachYomiEvent+render"></a>
|
|
2374
|
-
|
|
2375
|
-
### nachYomiEvent.render([locale]) ⇒ <code>string</code>
|
|
2376
|
-
Returns name of tractate and page (e.g. "Beitzah 21").
|
|
2377
|
-
|
|
2378
|
-
**Kind**: instance method of [<code>NachYomiEvent</code>](#NachYomiEvent)
|
|
2379
|
-
|
|
2380
|
-
| Param | Type | Description |
|
|
2381
|
-
| --- | --- | --- |
|
|
2382
|
-
| [locale] | <code>string</code> | Optional locale name (defaults to active locale). |
|
|
2383
|
-
|
|
2384
|
-
<a name="NachYomiEvent+url"></a>
|
|
2385
|
-
|
|
2386
|
-
### nachYomiEvent.url() ⇒ <code>string</code>
|
|
2387
|
-
Returns a link to sefaria.org
|
|
2388
|
-
|
|
2389
|
-
**Kind**: instance method of [<code>NachYomiEvent</code>](#NachYomiEvent)
|
|
2390
|
-
<a name="YerushalmiYomiEvent"></a>
|
|
2391
|
-
|
|
2392
|
-
## YerushalmiYomiEvent
|
|
2393
|
-
Event wrapper around a Yerushalmi Yomi result
|
|
2394
|
-
|
|
2395
|
-
**Kind**: global class
|
|
2157
|
+
| name | <code>string</code> |
|
|
2158
|
+
| calendar | <code>function</code> |
|
|
2396
2159
|
|
|
2397
|
-
|
|
2398
|
-
* [new YerushalmiYomiEvent(date, daf)](#new_YerushalmiYomiEvent_new)
|
|
2399
|
-
* [.render([locale])](#YerushalmiYomiEvent+render) ⇒ <code>string</code>
|
|
2400
|
-
* [.renderBrief([locale])](#YerushalmiYomiEvent+renderBrief) ⇒ <code>string</code>
|
|
2401
|
-
* [.url()](#YerushalmiYomiEvent+url) ⇒ <code>string</code>
|
|
2160
|
+
<a name="DailyLearning.lookup"></a>
|
|
2402
2161
|
|
|
2403
|
-
|
|
2162
|
+
### DailyLearning.lookup(name, hd) ⇒ [<code>Event</code>](#Event)
|
|
2163
|
+
Returns an event from daily calendar for a given date. Returns `null` if there
|
|
2164
|
+
is no learning from this calendar on this date.
|
|
2404
2165
|
|
|
2405
|
-
|
|
2166
|
+
**Kind**: static method of [<code>DailyLearning</code>](#DailyLearning)
|
|
2406
2167
|
|
|
2407
2168
|
| Param | Type |
|
|
2408
2169
|
| --- | --- |
|
|
2409
|
-
|
|
|
2410
|
-
|
|
|
2411
|
-
|
|
2412
|
-
<a name="YerushalmiYomiEvent+render"></a>
|
|
2413
|
-
|
|
2414
|
-
### yerushalmiYomiEvent.render([locale]) ⇒ <code>string</code>
|
|
2415
|
-
Returns name of tractate and page (e.g. "Yerushalmi Beitzah 21").
|
|
2416
|
-
|
|
2417
|
-
**Kind**: instance method of [<code>YerushalmiYomiEvent</code>](#YerushalmiYomiEvent)
|
|
2418
|
-
|
|
2419
|
-
| Param | Type | Description |
|
|
2420
|
-
| --- | --- | --- |
|
|
2421
|
-
| [locale] | <code>string</code> | Optional locale name (defaults to active locale). |
|
|
2422
|
-
|
|
2423
|
-
<a name="YerushalmiYomiEvent+renderBrief"></a>
|
|
2424
|
-
|
|
2425
|
-
### yerushalmiYomiEvent.renderBrief([locale]) ⇒ <code>string</code>
|
|
2426
|
-
Returns name of tractate and page (e.g. "Beitzah 21").
|
|
2427
|
-
|
|
2428
|
-
**Kind**: instance method of [<code>YerushalmiYomiEvent</code>](#YerushalmiYomiEvent)
|
|
2429
|
-
|
|
2430
|
-
| Param | Type | Description |
|
|
2431
|
-
| --- | --- | --- |
|
|
2432
|
-
| [locale] | <code>string</code> | Optional locale name (defaults to active locale). |
|
|
2433
|
-
|
|
2434
|
-
<a name="YerushalmiYomiEvent+url"></a>
|
|
2435
|
-
|
|
2436
|
-
### yerushalmiYomiEvent.url() ⇒ <code>string</code>
|
|
2437
|
-
Returns a link to sefaria.org
|
|
2170
|
+
| name | <code>string</code> |
|
|
2171
|
+
| hd | [<code>HDate</code>](#HDate) |
|
|
2438
2172
|
|
|
2439
|
-
**Kind**: instance method of [<code>YerushalmiYomiEvent</code>](#YerushalmiYomiEvent)
|
|
2440
2173
|
<a name="HebrewCalendar"></a>
|
|
2441
2174
|
|
|
2442
2175
|
## HebrewCalendar
|
|
@@ -2493,14 +2226,16 @@ Set `options.il=true` to use the Israeli schedule.
|
|
|
2493
2226
|
Additional non-default event types can be specified:
|
|
2494
2227
|
* Parashat HaShavua - weekly Torah Reading on Saturdays (`options.sedrot`)
|
|
2495
2228
|
* Counting of the Omer (`options.omer`)
|
|
2496
|
-
* Babylonian Talmud Daf Yomi (`options.dafyomi`)
|
|
2497
|
-
* Jerusalem Talmud (Yerushalmi) Yomi (`options.yerushalmi`)
|
|
2498
|
-
* Mishna Yomi (`options.mishnaYomi`)
|
|
2499
|
-
* Nach Yomi (`options.nachYomi`)
|
|
2500
2229
|
* Shabbat Mevarchim HaChodesh on Saturday before Rosh Chodesh (`options.shabbatMevarchim`)
|
|
2501
2230
|
* Molad announcement on Saturday before Rosh Chodesh (`options.molad`)
|
|
2502
2231
|
* Yom Kippur Katan (`options.yomKippurKatan`)
|
|
2503
2232
|
|
|
2233
|
+
Daily Study of texts:
|
|
2234
|
+
* Babylonian Talmud Daf Yomi (`options.dailyLearning.dafYomi`)
|
|
2235
|
+
* Jerusalem Talmud (Yerushalmi) Yomi (`options.dailyLearning.yerushalmi`)
|
|
2236
|
+
* Mishna Yomi (`options.dailyLearning.mishnaYomi`)
|
|
2237
|
+
* Nach Yomi (`options.dailyLearning.nachYomi`)
|
|
2238
|
+
|
|
2504
2239
|
Candle-lighting and Havdalah times are approximated using latitude and longitude
|
|
2505
2240
|
specified by the [Location](#Location) class. The `Location` class contains a small
|
|
2506
2241
|
database of cities with their associated geographic information and time-zone information.
|
|
@@ -2933,20 +2668,6 @@ Clamen, Software--Practice and Experience, Volume 23, Number 4
|
|
|
2933
2668
|
The 54 parshiyot of the Torah as transilterated strings
|
|
2934
2669
|
parshiot[0] == 'Bereshit', parshiot[1] == 'Noach', parshiot[53] == "Ha'Azinu".
|
|
2935
2670
|
|
|
2936
|
-
**Kind**: global constant
|
|
2937
|
-
**Read only**: true
|
|
2938
|
-
<a name="vilna"></a>
|
|
2939
|
-
|
|
2940
|
-
## vilna
|
|
2941
|
-
Yerushalmi Yomi configuration for Vilna Edition
|
|
2942
|
-
|
|
2943
|
-
**Kind**: global constant
|
|
2944
|
-
**Read only**: true
|
|
2945
|
-
<a name="schottenstein"></a>
|
|
2946
|
-
|
|
2947
|
-
## schottenstein
|
|
2948
|
-
Yerushalmi Yomi configuration for Schottenstein Edition
|
|
2949
|
-
|
|
2950
2671
|
**Kind**: global constant
|
|
2951
2672
|
**Read only**: true
|
|
2952
2673
|
<a name="gematriya"></a>
|
|
@@ -2971,30 +2692,6 @@ gematriya(60) // 'ס׳'
|
|
|
2971
2692
|
gematriya(3761) // 'ג׳תשס״א'
|
|
2972
2693
|
gematriya(1123) // 'א׳קכ״ג'
|
|
2973
2694
|
```
|
|
2974
|
-
<a name="yerushalmiYomi"></a>
|
|
2975
|
-
|
|
2976
|
-
## yerushalmiYomi(date, config) ⇒ <code>any</code>
|
|
2977
|
-
Using the Vilna edition, the Yerushalmi Daf Yomi program takes
|
|
2978
|
-
~4.25 years or 51 months.
|
|
2979
|
-
Unlike the Daf Yomi Bavli cycle, this Yerushalmi cycle skips both
|
|
2980
|
-
Yom Kippur and Tisha B'Av (returning `null`).
|
|
2981
|
-
The page numbers are according to the Vilna
|
|
2982
|
-
Edition which is used since 1900.
|
|
2983
|
-
|
|
2984
|
-
The Schottenstein edition uses different page numbers and takes
|
|
2985
|
-
~6 years to complete.
|
|
2986
|
-
|
|
2987
|
-
Throws an exception if the date is before Daf Yomi Yerushalmi
|
|
2988
|
-
cycle began (2 February 1980 for Vilna,
|
|
2989
|
-
14 November 2022 for Schottenstein).
|
|
2990
|
-
|
|
2991
|
-
**Kind**: global function
|
|
2992
|
-
|
|
2993
|
-
| Param | Type | Description |
|
|
2994
|
-
| --- | --- | --- |
|
|
2995
|
-
| date | [<code>HDate</code>](#HDate) \| <code>Date</code> \| <code>number</code> | Hebrew or Gregorian date |
|
|
2996
|
-
| config | <code>any</code> | either vilna or schottenstein |
|
|
2997
|
-
|
|
2998
2695
|
<a name="ZmanimTimesResult"></a>
|
|
2999
2696
|
|
|
3000
2697
|
## ZmanimTimesResult : <code>Object</code>
|
|
@@ -3035,32 +2732,6 @@ Result of Sedra.lookup
|
|
|
3035
2732
|
| chag | <code>boolean</code> | True if this is a regular parasha HaShavua Torah reading, false if it's a special holiday reading |
|
|
3036
2733
|
| num | <code>number</code> \| <code>Array.<number></code> | the parsha number (or numbers) using 1-indexing. A `number` for a regular (single) parsha, and a `number[]` for a doubled parsha. For Parashat *Bereshit*, `num` would be equal to `1`, and for *Matot-Masei* it would be `[42, 43]` |
|
|
3037
2734
|
|
|
3038
|
-
<a name="MishnaYomi"></a>
|
|
3039
|
-
|
|
3040
|
-
## MishnaYomi : <code>Object</code>
|
|
3041
|
-
Describes a mishna to be read
|
|
3042
|
-
|
|
3043
|
-
**Kind**: global typedef
|
|
3044
|
-
**Properties**
|
|
3045
|
-
|
|
3046
|
-
| Name | Type | Description |
|
|
3047
|
-
| --- | --- | --- |
|
|
3048
|
-
| k | <code>string</code> | tractate name in Sephardic transliteration (e.g. "Berakhot", "Moed Katan") |
|
|
3049
|
-
| v | <code>string</code> | verse (e.g. "2:1") |
|
|
3050
|
-
|
|
3051
|
-
<a name="NachYomi"></a>
|
|
3052
|
-
|
|
3053
|
-
## NachYomi : <code>Object</code>
|
|
3054
|
-
Describes a chapter to be read
|
|
3055
|
-
|
|
3056
|
-
**Kind**: global typedef
|
|
3057
|
-
**Properties**
|
|
3058
|
-
|
|
3059
|
-
| Name | Type | Description |
|
|
3060
|
-
| --- | --- | --- |
|
|
3061
|
-
| k | <code>string</code> | book name in Sephardic transliteration (e.g. "Berakhot", "Moed Katan") |
|
|
3062
|
-
| v | <code>number</code> | chapter (e.g. "2:1") |
|
|
3063
|
-
|
|
3064
2735
|
<a name="CalOptions"></a>
|
|
3065
2736
|
|
|
3066
2737
|
## CalOptions : <code>Object</code>
|
|
@@ -3090,11 +2761,6 @@ Options to configure which events are returned
|
|
|
3090
2761
|
| shabbatMevarchim | <code>boolean</code> | add Shabbat Mevarchim |
|
|
3091
2762
|
| noSpecialShabbat | <code>boolean</code> | suppress Special Shabbat |
|
|
3092
2763
|
| noHolidays | <code>boolean</code> | suppress regular holidays |
|
|
3093
|
-
| dafyomi | <code>boolean</code> | Babylonian Talmud Daf Yomi |
|
|
3094
|
-
| yerushalmi | <code>boolean</code> | Jerusalem Talmud (Yerushalmi) Yomi |
|
|
3095
|
-
| yerushalmiEdition | <code>number</code> | Use 1 for Vilna, 2 for Schottenstein |
|
|
3096
|
-
| mishnaYomi | <code>boolean</code> | include Mishna Yomi |
|
|
3097
|
-
| nachYomi | <code>boolean</code> | include Nach Yomi |
|
|
3098
2764
|
| omer | <code>boolean</code> | include Days of the Omer |
|
|
3099
2765
|
| molad | <code>boolean</code> | include event announcing the molad |
|
|
3100
2766
|
| ashkenazi | <code>boolean</code> | use Ashkenazi transliterations for event titles (default Sephardi transliterations) |
|
|
@@ -3104,6 +2770,7 @@ Options to configure which events are returned
|
|
|
3104
2770
|
| mask | <code>number</code> | use bitmask from `flags` to filter events |
|
|
3105
2771
|
| yomKippurKatan | <code>boolean</code> | include 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](https://en.wikipedia.org/wiki/Yom_Kippur_Katan#Practices) |
|
|
3106
2772
|
| hour12 | <code>boolean</code> | Whether to use 12-hour time (as opposed to 24-hour time). Possible values are `true` and `false`; the default is locale dependent. |
|
|
2773
|
+
| dailyLearning | <code>Object.<string, any></code> | map 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). |
|
|
3107
2774
|
|
|
3108
2775
|
<a name="TachanunResult"></a>
|
|
3109
2776
|
|