@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 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="#MishnaYomiIndex">MishnaYomiIndex</a></dt>
120
- <dd><p>A program of daily learning in which participants study two Mishnahs
121
- each day in order to finish the entire Mishnah in ~6 years.</p>
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&#39;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] == &#39;Bereshit&#39;, parshiot[1] == &#39;Noach&#39;, parshiot[53] == &quot;Ha&#39;Azinu&quot;.</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] == &#39;Bereshit&#39;, parshiot[1] == &#39;Noach&#39;, 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&#39;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>LocaleDate</code> | parsed data from a `.po` file. |
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.&lt;string&gt;</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.&lt;string&gt;</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.&lt;string&gt;</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.&lt;string&gt;</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.&lt;string&gt;</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.&lt;string&gt;</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="MishnaYomiIndex"></a>
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.&lt;MishnaYomi&gt;</code>](#MishnaYomi)
2264
- * [.lookup(date)](#MishnaYomiIndex+lookup) ⇒ [<code>Array.&lt;MishnaYomi&gt;</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.&lt;MishnaYomi&gt;</code>](#MishnaYomi)
2274
- **Kind**: instance property of [<code>MishnaYomiIndex</code>](#MishnaYomiIndex)
2275
- <a name="MishnaYomiIndex+lookup"></a>
2276
-
2277
- ### mishnaYomiIndex.lookup(date) ⇒ [<code>Array.&lt;MishnaYomi&gt;</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
- <a name="MishnaYomiEvent"></a>
2137
+ ## DailyLearning
2138
+ Plug-ins for daily learning calendars such as Daf Yomi, Mishna Yomi, Nach Yomi, etc.
2287
2139
 
2288
- ## MishnaYomiEvent
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
- * [MishnaYomiEvent](#MishnaYomiEvent)
2294
- * [new MishnaYomiEvent(date, mishnaYomi)](#new_MishnaYomiEvent_new)
2295
- * [.render([locale])](#MishnaYomiEvent+render) ⇒ <code>string</code>
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="new_MishnaYomiEvent_new"></a>
2148
+ <a name="DailyLearning.addCalendar"></a>
2299
2149
 
2300
- ### new MishnaYomiEvent(date, mishnaYomi)
2301
-
2302
- | Param | Type |
2303
- | --- | --- |
2304
- | date | [<code>HDate</code>](#HDate) |
2305
- | mishnaYomi | [<code>Array.&lt;MishnaYomi&gt;</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
- <a name="MishnaYomiEvent+url"></a>
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
- | date | [<code>HDate</code>](#HDate) |
2371
- | nachYomi | [<code>NachYomi</code>](#NachYomi) |
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
- * [YerushalmiYomiEvent](#YerushalmiYomiEvent)
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
- <a name="new_YerushalmiYomiEvent_new"></a>
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
- ### new YerushalmiYomiEvent(date, daf)
2166
+ **Kind**: static method of [<code>DailyLearning</code>](#DailyLearning)
2406
2167
 
2407
2168
  | Param | Type |
2408
2169
  | --- | --- |
2409
- | date | [<code>HDate</code>](#HDate) |
2410
- | daf | <code>any</code> |
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.&lt;number&gt;</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.&lt;string, any&gt;</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