@hebcal/core 6.0.8 → 6.2.0

package/dist/src/zmanim.js

@@ -1,6 +1,7 @@
 import 'temporal-polyfill/global';
 import { NOAACalculator } from '@hebcal/noaa';
 import { HDate, getPseudoISO, getTimezoneOffset, isDate, pad2, } from '@hebcal/hdate';
+import { Molad } from './molad';
 /**
  * @private
  */
@@ -19,6 +20,19 @@ function getDate(date) {
         return date.greg();
     throw new TypeError(`invalid date: ${date}`);
 }
+/**
+ * The zenith of astronomical sunrise and sunset. The sun is 90° from the vertical 0°
+ */
+const GEOMETRIC_ZENITH = 90;
+/**
+ * The zenith of 1.583° below {@link GEOMETRIC_ZENITH geometric zenith} (90°). This calculation is used for
+ * calculating _netz amiti_ (sunrise) and _shkiah amiti_ (sunset) based on the opinion of the
+ * <a href="https://en.wikipedia.org/wiki/Shneur_Zalman_of_Liadi">Baal Hatanya</a>.
+ *
+ * @see Zmanim.sunriseBaalHatanya()
+ * @see Zmanim.sunsetBaalHatanya()
+ */
+const ZENITH_1_POINT_583 = GEOMETRIC_ZENITH + 1.583;
 /**
  * Calculate halachic times (zmanim / זְמַנִּים) for a given day and location.
  * Calculations are available for tzeit / tzais (nightfall),
@@ -46,6 +60,10 @@ function getDate(date) {
  * const timeStr = Zmanim.formatISOWithTimeZone(tzid, candleLighting);
  */
 export class Zmanim {
+    plainDate;
+    gloc;
+    noaa;
+    useElevation;
     /**
      * Initialize a Zmanim instance.
      * @param gloc GeoLocation including latitude, longitude, and timezone
@@ -59,14 +77,13 @@ export class Zmanim {
      */
     constructor(gloc, date, useElevation) {
         const dt = getDate(date);
-        this.date = dt;
-        this.gloc = gloc;
-        const plainDate = Temporal.PlainDate.from({
+        this.plainDate = Temporal.PlainDate.from({
             year: dt.getFullYear(),
             month: dt.getMonth() + 1,
             day: dt.getDate(),
         });
-        this.noaa = new NOAACalculator(gloc, plainDate);
+        this.gloc = gloc;
+        this.noaa = new NOAACalculator(gloc, this.plainDate);
         this.useElevation = Boolean(useElevation);
     }
     /**
@@ -91,7 +108,7 @@ export class Zmanim {
      * @param rising
      */
     timeAtAngle(angle, rising) {
-        const offsetZenith = 90 + angle;
+        const offsetZenith = GEOMETRIC_ZENITH + angle;
         const zdt = rising
             ? this.noaa.getSunriseOffsetByDegrees(offsetZenith)
             : this.noaa.getSunsetOffsetByDegrees(offsetZenith);
@@ -156,8 +173,8 @@ export class Zmanim {
      * If elevation is enabled, this function will include elevation in the calculation.
      */
     gregEve() {
-        const prev = new Date(this.date);
-        prev.setDate(prev.getDate() - 1);
+        const prev0 = this.plainDate.subtract({ days: 1 });
+        const prev = new Date(prev0.year, prev0.month - 1, prev0.day);
         const zman = new Zmanim(this.gloc, prev, this.useElevation);
         return zman.sunset();
     }
@@ -198,6 +215,15 @@ export class Zmanim {
     alotHaShachar72() {
         return this.sunriseOffset(-72, false, false);
     }
+    alotHaShachar72zdt() {
+        const zdt = this.useElevation
+            ? this.noaa.getSunrise()
+            : this.noaa.getSeaLevelSunrise();
+        if (!zdt) {
+            return null;
+        }
+        return zdt.subtract({ minutes: 72 });
+    }
     /**
      * Earliest talis & tefillin – Misheyakir; Sun is 11.5° below the horizon in the morning.
      * Because degree-based functions estimate the amount of light in the sky,
@@ -214,6 +240,12 @@ export class Zmanim {
     misheyakirMachmir() {
         return this.timeAtAngle(10.2, true);
     }
+    getShaahZmanisBasedZmanZdt(startOfDay, endOfDay, hours) {
+        const temporalHour = this.noaa.getTemporalHour(startOfDay, endOfDay);
+        const offset = Math.trunc(temporalHour * hours);
+        const zdt = NOAACalculator.getTimeOffset(startOfDay, offset);
+        return zdt;
+    }
     /**
      * Utility method for using elevation-aware sunrise/sunset
      * @private
@@ -226,9 +258,7 @@ export class Zmanim {
         const endOfDay = this.useElevation
             ? this.noaa.getSunset()
             : this.noaa.getSeaLevelSunset();
-        const temporalHour = this.noaa.getTemporalHour(startOfDay, endOfDay);
-        const offset = Math.round(temporalHour * hours);
-        const zdt = NOAACalculator.getTimeOffset(startOfDay, offset);
+        const zdt = this.getShaahZmanisBasedZmanZdt(startOfDay, endOfDay, hours);
         return zdtToDate(zdt);
     }
     /**
@@ -412,6 +442,15 @@ export class Zmanim {
     tzeit(angle = 8.5) {
         return this.timeAtAngle(angle, false);
     }
+    tzeit72() {
+        const zdt = this.useElevation
+            ? this.noaa.getSunset()
+            : this.noaa.getSeaLevelSunset();
+        if (!zdt) {
+            return null;
+        }
+        return zdt.add({ minutes: 72 });
+    }
     /**
      * Alias for sunrise
      */
@@ -440,6 +479,386 @@ export class Zmanim {
         }
         return new Date(millis - 13.5 * 60 * 1000);
     }
+    /**
+     * Used by Molad based _zmanim_ to determine if _zmanim_ occur during the current day.
+     * @return previous midnight
+     */
+    getMidnightLastNight() {
+        // reset hour, minutes, seconds and millis
+        return this.plainDate.toZonedDateTime({
+            timeZone: this.gloc.getTimeZone(),
+        });
+    }
+    /**
+     * Used by Molad based _zmanim_ to determine if _zmanim_ occur during the current day.
+     * @return following midnight
+     */
+    getMidnightTonight() {
+        return this.plainDate.add({ days: 1 }).toZonedDateTime({
+            timeZone: this.gloc.getTimeZone(),
+        });
+    }
+    /**
+     * Returns the Date of the _molad_ based time if it occurs on the current date. Since _Kiddush Levana_
+     * can only be said during the day, there are parameters to limit it to between _alos_ and _tzais_. If
+     * the time occurs between _alos_ and _tzais_, _tzais_ will be returned.
+     *
+     * @param moladBasedTime
+     *            the _molad_ based time such as _molad_, _tchilas_ and _sof zman Kiddush Levana_
+     * @param alos
+     *            optional start of day to limit _molad_ times to the end of the night before or beginning of the next night.
+     *            Ignored if either _alos_ or _tzais_ are null.
+     * @param tzais
+     *            optional end of day to limit _molad_ times to the end of the night before or beginning of the next night.
+     *            Ignored if either _tzais_ or _alos_ are null
+     * @param techila
+     *            is it the start of _Kiddush Levana_ time or the end? If it is start roll it to the next _tzais_,
+     *            and if it is the end, return the end of the previous night (_alos_ passed in). Ignored if either
+     *            _alos_ or _tzais_ are null.
+     * @return the _molad_ based time. If the _zman_ does not occur during the current date, `null` will be
+     *         returned.
+     */
+    getMoladBasedTime(moladBasedTime, alos, tzais, techila) {
+        const lastMidnight = this.getMidnightLastNight();
+        const midnightTonight = this.getMidnightTonight();
+        if (Temporal.ZonedDateTime.compare(moladBasedTime, lastMidnight) < 0 ||
+            Temporal.ZonedDateTime.compare(moladBasedTime, midnightTonight) > 0) {
+            return null; // Invalid time, bailout
+        }
+        if (alos === null || tzais === null) {
+            return moladBasedTime.withTimeZone(this.gloc.getTimeZone()); // Not enough info to adjust
+        }
+        if (Temporal.ZonedDateTime.compare(moladBasedTime, alos) > 0 &&
+            Temporal.ZonedDateTime.compare(moladBasedTime, tzais) < 0) {
+            // It's the daytime (after alos but before tzais)
+            // get the next/prev night
+            return techila ? tzais : alos;
+        }
+        // It's the night, the provided time is valid
+        return moladBasedTime.withTimeZone(this.gloc.getTimeZone());
+    }
+    getHDate() {
+        const dt = new Date(this.plainDate.year, this.plainDate.month - 1, this.plainDate.day);
+        return new HDate(dt);
+    }
+    /**
+     * Returns the latest time of Kiddush Levana according to the <a
+     * href="https://en.wikipedia.org/wiki/Yaakov_ben_Moshe_Levi_Moelin">Maharil's</a> opinion that it is calculated as
+     * halfway between _molad_ and _molad_. This adds half the 29 days, 12 hours and 793 chalakim time between
+     * _molad_ and _molad_ (14 days, 18 hours, 22 minutes and 666 milliseconds) to the month's _molad_.
+     * The _sof zman Kiddush Levana_ will be returned even if it occurs during the day. To limit the time to between
+     * _tzais_ and _alos_, see {@link getSofZmanKidushLevanaBetweenMoldos}.
+     *
+     * @param alos
+     *            the beginning of the Jewish day. If _Kidush Levana_ occurs during the day (starting at _alos_ and
+     *            ending at _tzais_), the time returned will be alos. If either the _alos_ or _tzais_ parameters
+     *            are null, no daytime adjustment will be made.
+     * @param tzais
+     *            the end of the Jewish day. If Kidush Levana occurs during the day (starting at alos and ending at
+     *            tzais), the time returned will be alos. If either the alos or tzais parameters are null, no daytime
+     *            adjustment will be made.
+     * @return the Date representing the moment halfway between molad and molad. If the time occurs between
+     *         _alos_ and _tzais_, _alos_ will be returned. If the _zman_ will not occur on this
+     *         day, a `null` will be returned.
+     */
+    getSofZmanKidushLevanaBetweenMoldos(alos = null, tzais = null) {
+        const hd = this.getHDate();
+        // Do not calculate for impossible dates, but account for extreme cases. In the extreme case of Rapa Iti in French
+        // Polynesia on Dec 2027 when kiddush Levana 3 days can be said on _Rosh Chodesh_, the sof zman Kiddush Levana
+        // will be on the 12th of the Teves. In the case of Anadyr, Russia on Jan, 2071, sof zman Kiddush Levana between the
+        // moldos will occur is on the night of 17th of Shevat. See Rabbi Dovid Heber's Shaarei Zmanim chapter 4 (pages 28 and 32).
+        if (hd.getDate() < 11 || hd.getDate() > 16) {
+            return null;
+        }
+        const molad = new Molad(hd.getFullYear(), hd.getMonth());
+        return this.getMoladBasedTime(molad.getSofZmanKidushLevanaBetweenMoldos(), alos, tzais, false);
+    }
+    /**
+     * Returns the latest time of _Kiddush Levana_ calculated as 15 days after the molad. This is the opinion of
+     * the Shulchan Aruch (Orach Chaim 426). It should be noted that some opinions hold that the
+     * <a href="https://en.wikipedia.org/wiki/Moses_Isserles">Rema</a> who brings down the opinion of the <a
+     * href="https://en.wikipedia.org/wiki/Yaakov_ben_Moshe_Levi_Moelin">Maharil's</a> of calculating
+     * {@link getSofZmanKidushLevanaBetweenMoldos half way between _molad_ and _molad_} is of
+     * the opinion that the Mechaber agrees to his opinion. Also see the Aruch Hashulchan. For additional details on the subject,
+     * See Rabbi Dovid Heber's very detailed write-up in Siman Daled (chapter 4) of <a href="https://hebrewbooks.org/53000">Shaarei
+     * Zmanim</a>. The _sof zman Kiddush Levana_ will be returned even if it occurs during the day. To limit the time to
+     * between _tzais_ and _alos_, see {@link getSofZmanKidushLevana15Days}.
+     *
+     * @return the Date representing the moment 15 days after the _molad_. If the time occurs between
+     *         _alos_ and _tzais_, _alos_ will be returned. If the _zman_ will not occur on this day, a
+     *         `null` will be returned.
+     *
+     *
+     */
+    getSofZmanKidushLevana15Days(alos = null, tzais = null) {
+        const hd = this.getHDate();
+        // Do not calculate for impossible dates, but account for extreme cases. In the extreme case of Rapa Iti in
+        // French Polynesia on Dec 2027 when kiddush Levana 3 days can be said on _Rosh Chodesh_, the sof zman Kiddush
+        // Levana will be on the 12th of the Teves. in the case of Anadyr, Russia on Jan, 2071, sof zman kiddush levana will
+        // occur after midnight on the 17th of Shevat. See Rabbi Dovid Heber's Shaarei Zmanim chapter 4 (pages 28 and 32).
+        if (hd.getDate() < 11 || hd.getDate() > 17) {
+            return null;
+        }
+        const molad = new Molad(hd.getFullYear(), hd.getMonth());
+        return this.getMoladBasedTime(molad.getSofZmanKidushLevana15Days(), alos, tzais, false);
+    }
+    /**
+     * Returns the earliest time of _Kiddush Levana_ according to <a href=
+     * "https://en.wikipedia.org/wiki/Yonah_Gerondi">Rabbeinu Yonah</a>'s opinion that it can be said 3 days after the _molad_.
+     * If the time of _tchilas zman Kiddush Levana_ occurs during the day (between _alos_ and _tzais_ passed to
+     * this method) it will return the following _tzais_. If null is passed for either _alos_ or _tzais_, the actual
+     * _tchilas zman Kiddush Levana_ will be returned, regardless of if it is during the day or not.
+     *
+     * @param alos
+     *            the beginning of the Jewish day. If Kidush Levana occurs during the day (starting at _alos_ and ending
+     *            at _tzais_), the time returned will be _tzais_. If either the _alos_ or _tzais_ parameters
+     *            are null, no daytime adjustment will be made.
+     * @param tzais
+     *            the end of the Jewish day. If _Kidush Levana_ occurs during the day (starting at _alos_ and ending at
+     *            _tzais_), the time returned will be _tzais_. If either the _alos_ or _tzais_ parameters
+     *            are null, no daytime adjustment will be made.
+     *
+     * @return the Date representing the moment 3 days after the molad. If the time occurs between _alos_ and
+     *         _tzais_, _tzais_ will be returned. If the _zman_ will not occur on this day, a
+     *         `null` will be returned.
+     */
+    getTchilasZmanKidushLevana3Days(alos = null, tzais = null) {
+        const hd = this.getHDate();
+        // Do not calculate for impossible dates, but account for extreme cases. Tchilas zman kiddush Levana 3 days for
+        // the extreme case of Rapa Iti in French Polynesia on Dec 2027 when kiddush Levana 3 days can be said on the evening
+        // of the 30th, the second night of Rosh Chodesh. The 3rd day after the _molad_ will be on the 4th of the month.
+        // In the case of Anadyr, Russia on Jan, 2071, when sof zman kiddush levana is on the 17th of the month, the 3rd day
+        // from the molad will be on the 5th day of Shevat. See Rabbi Dovid Heber's Shaarei Zmanim chapter 4 (pages 28 and 32).
+        if (hd.getDate() > 5 && hd.getDate() < 30) {
+            return null;
+        }
+        const molad = new Molad(hd.getFullYear(), hd.getMonth());
+        let zman = this.getMoladBasedTime(molad.getTchilasZmanKidushLevana3Days(), alos, tzais, true);
+        // Get the following month's zman kiddush Levana for the extreme case of Rapa Iti in French Polynesia on Dec 2027 when
+        // kiddush Levana can be said on Rosh Chodesh (the evening of the 30th). See Rabbi Dovid Heber's Shaarei Zmanim chapter 4 (page 32)
+        if (zman === null && hd.getDate() === 30) {
+            const hd2 = hd.add(1, 'week');
+            const molad2 = new Molad(hd2.getFullYear(), hd2.getMonth());
+            zman = this.getMoladBasedTime(molad2.getTchilasZmanKidushLevana3Days(), null, null, true);
+        }
+        return zman;
+    }
+    /**
+     * Returns the point in time of _Molad_ as a <code>Date</code> Object. For the traditional day of week, hour,
+     * minute and chalakim, {@link Molad.getInstant()} and the not yet completed
+     * {@link HebrewDateFormatter} that will have formatting for this.
+     *
+     * @return the Date representing the moment of the molad. If the _molad_ does not occur on this day, a
+     *         `null` will be returned.
+     *
+     */
+    getZmanMolad() {
+        const hd = this.getHDate();
+        // Optimize to not calculate for impossible dates, but account for extreme cases. The molad in the extreme case of Rapa
+        // Iti in French Polynesia on Dec 2027 occurs on the night of the 27th of Kislev. In the case of Anadyr, Russia on
+        // Jan 2071, the molad will be on the 2nd day of Shevat. See Rabbi Dovid Heber's Shaarei Zmanim chapter 4 (pages 28 and 32).
+        if (hd.getDate() > 2 && hd.getDate() < 27) {
+            return null;
+        }
+        const molad = new Molad(hd.getFullYear(), hd.getMonth());
+        let zman = this.getMoladBasedTime(molad.getInstant(), null, null, true);
+        // deal with molad that happens on the end of the previous month
+        if (zman === null && hd.getDate() > 26) {
+            const hd2 = hd.add(1, 'week');
+            const molad2 = new Molad(hd2.getFullYear(), hd2.getMonth());
+            zman = this.getMoladBasedTime(molad2.getInstant(), null, null, true);
+        }
+        return zman;
+    }
+    /**
+     * Returns the earliest time of _Kiddush Levana_ according to the opinions that it should not be said until 7
+     * days after the _molad_. The time will be returned even if it occurs during the day when _Kiddush Levana_
+     * can't be recited. Use {@link getTchilasZmanKidushLevana7Days} if you want to limit the time to night hours.
+     *
+     * @return the Date representing the moment 7 days after the molad regardless of it is day or night. If the _zman_
+     *         will not occur on this day, a `null` will be returned.
+     */
+    getTchilasZmanKidushLevana7Days(alos = null, tzais = null) {
+        const hd = this.getHDate();
+        // Optimize to not calculate for impossible dates, but account for extreme cases. Tchilas zman kiddush Levana 7 days for
+        // the extreme case of Rapa Iti in French Polynesia on Jan 2028 (when kiddush Levana 3 days can be said on the evening
+        // of the 30th, the second night of Rosh Chodesh), the 7th day after the molad will be on the 4th of the month.
+        // In the case of Anadyr, Russia on Jan, 2071, when sof zman kiddush levana is on the 17th of the month, the 7th day
+        // from the molad will be on the 9th day of Shevat. See Rabbi Dovid Heber's Shaarei Zmanim chapter 4 (pages 28 and 32).
+        if (hd.getDate() < 4 || hd.getDate() > 9) {
+            return null;
+        }
+        const molad = new Molad(hd.getFullYear(), hd.getMonth());
+        return this.getMoladBasedTime(molad.getTchilasZmanKidushLevana7Days(), alos, tzais, true);
+    }
+    /**
+     * A method that returns the <a href="https://en.wikipedia.org/wiki/Shneur_Zalman_of_Liadi">Baal Hatanya</a>'s
+     * _netz amiti_ (sunrise) without
+     * elevation adjustment. This forms the base for the Baal Hatanya's dawn-based calculations that are
+     * calculated as a dip below the horizon before sunrise.
+     *
+     * According to the Baal Hatanya, _netz amiti_, or true (halachic) sunrise, is when the top of the sun's
+     * disk is visible at an elevation similar to the mountains of Eretz Yisrael. The time is calculated as the point at which
+     * the center of the sun's disk is 1.583&deg; below the horizon. This degree-based calculation can be found in Rabbi Shalom
+     * DovBer Levine's commentary on The <a href="https://www.chabadlibrary.org/books/pdf/Seder-Hachnosas-Shabbos.pdf">Baal
+     * Hatanya's Seder Hachnasas Shabbos</a>. From an elevation of 546 meters, the top of <a href=
+     * "https://en.wikipedia.org/wiki/Mount_Carmel">Har Hacarmel</a>, the sun disappears when it is 1&deg; 35' or 1.583&deg;
+     * below the sea level horizon. This in turn is based on the Gemara <a href=
+     * "https://hebrewbooks.org/shas.aspx?mesechta=2&daf=35">Shabbos 35a</a>. There are other opinions brought down by
+     * Rabbi Levine, including Rabbi Yosef Yitzchok Feigelstock who calculates it as the degrees below the horizon 4 minutes after
+     * sunset in Yerushalayim (on the equinox). That is brought down as 1.583&deg;. This is identical to the 1&deg; 35' _zman_
+     * and is probably a typo and should be 1.683&deg;. These calculations are used by most <a href=
+     * "https://en.wikipedia.org/wiki/Chabad">Chabad</a> calendars that use the Baal Hatanya's _zmanim_. See
+     * <a href="https://www.chabad.org/library/article_cdo/aid/3209349/jewish/About-Our-Zmanim-Calculations.htm">About Our
+     * _Zmanim_ Calculations @ Chabad.org</a>.
+     *
+     * Note: _netz amiti_ is used only for calculating certain _zmanim_, and is intentionally unpublished. For
+     * practical purposes, daytime _mitzvos_ like _shofar_ and _lulav_ should not be done until after the
+     * published time for _netz_ / sunrise.
+     *
+     * @return the <code>Date</code> representing the exact sea level _netz amiti_ (sunrise) time. If the calculation can't be
+     *         computed such as in the Arctic Circle where there is at least one day a year where the sun does not rise, and one
+     *         where it does not set, a `null` will be returned. See detailed explanation on top of the page.
+     *
+     * @see ZENITH_1_POINT_583
+     */
+    getSunriseBaalHatanya() {
+        return this.noaa.getSunriseOffsetByDegrees(ZENITH_1_POINT_583);
+    }
+    /**
+     * A method that returns the <a href="https://en.wikipedia.org/wiki/Shneur_Zalman_of_Liadi">Baal Hatanya</a>'s
+     * _shkiah amiti_ (sunset) without
+     * elevation adjustment. This forms the base for the Baal Hatanya's dusk-based calculations that are calculated
+     * as a dip below the horizon after sunset.
+     *
+     * According to the Baal Hatanya, _shkiah amiti_, true (_halachic_) sunset, is when the top of the
+     * sun's disk disappears from view at an elevation similar to the mountains of _Eretz Yisrael_.
+     * This time is calculated as the point at which the center of the sun's disk is 1.583 degrees below the horizon.
+     *
+     * Note: _shkiah amiti_ is used only for calculating certain _zmanim_, and is intentionally unpublished. For
+     * practical purposes, all daytime mitzvos should be completed before the published time for _shkiah_ / sunset.
+     *
+     * For further explanation of the calculations used for the Baal Hatanya's _zmanim_ in this library, see
+     * <a href="https://www.chabad.org/library/article_cdo/aid/3209349/jewish/About-Our-Zmanim-Calculations.htm">About Our
+     * _Zmanim_ Calculations @ Chabad.org</a>.
+     *
+     * @return the <code>Date</code> representing the exact sea level _shkiah amiti_ (sunset) time. If the calculation
+     *         can't be computed such as in the Arctic Circle where there is at least one day a year where the sun does not
+     *         rise, and one where it does not set, a `null` will be returned.
+     *
+     * @see ZENITH_1_POINT_583
+     */
+    getSunsetBaalHatanya() {
+        return this.noaa.getSunsetOffsetByDegrees(ZENITH_1_POINT_583);
+    }
+    /**
+     * Returns the <a href="https://en.wikipedia.org/wiki/Shneur_Zalman_of_Liadi">Baal Hatanya</a>'s _alos_
+     * (dawn) calculated as the time when the sun is 16.9&deg; below the eastern {@link GEOMETRIC_ZENITH geometric horizon}
+     * before {@link getSunrise() sunrise}.
+     *
+     * The zenith of 16.9&deg; below is based on the calculation that the time between dawn
+     * and <em>netz amiti</em> (sunrise) is 72 minutes, the time that is takes to walk 4 mil at 18 minutes
+     * a mil (<a href="https://en.wikipedia.org/wiki/Maimonides">Rambam</a> and others). The sun's position at 72
+     * minutes before {@link getSunriseBaalHatanya <em>netz amiti</em> (sunrise)} in Jerusalem <a href=
+     * "https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/">around the equinox / equilux</a> is
+     * 16.9&deg; below {@link GEOMETRIC_ZENITH geometric zenith}.
+     *
+     * @return The <code>Date</code> of dawn. If the calculation can't be computed such as northern and southern
+     *         locations even south of the Arctic Circle and north of the Antarctic Circle where the sun may not reach
+     *         low enough below the horizon for this calculation, a `null` will be returned.   */
+    alosBaalHatanya() {
+        return this.timeAtAngle(16.9, true);
+    }
+    getShaahZmanisBaalHatanya(hours) {
+        const zdt = this.getShaahZmanisBasedZmanZdt(this.getSunriseBaalHatanya(), this.getSunsetBaalHatanya(), hours);
+        return zdtToDate(zdt);
+    }
+    /**
+     * This method returns the latest _zman krias shema_ (time to recite Shema in the morning). This time is 3
+     * {@link shaahZmanisBaalHatanya() _shaos zmaniyos_} (solar hours) after {@link getSunriseBaalHatanya()
+     * _netz amiti_ (sunrise)} based on the opinion of the Baal Hatanya that the day is calculated from
+     * sunrise to sunset. This returns the time 3 * {@link getShaahZmanisBaalHatanya()} after {@link getSunriseBaalHatanya()
+     * _netz amiti_ (sunrise)}.
+     *
+     * @return the <code>Date</code> of the latest _zman shema_ according to the Baal Hatanya. If the calculation
+     *         can't be computed such as in the Arctic Circle where there is at least one day a year where the sun does
+     *         not rise, and one where it does not set, a `null` will be returned.
+     */
+    sofZmanShmaBaalHatanya() {
+        return this.getShaahZmanisBaalHatanya(3);
+    }
+    /**
+     * This method returns the latest _zman tfilah_ (time to recite the morning prayers). This time is 4
+     * hours into the day based on the opinion of the Baal Hatanya that the day is
+     * calculated from sunrise to sunset. This returns the time 4 * {@link getShaahZmanisBaalHatanya()} after
+     * {@link getSunriseBaalHatanya() _netz amiti_ (sunrise)}.
+     *
+     * @return the <code>Date</code> of the latest _zman tfilah_. If the calculation can't be computed such as in
+     *         the Arctic Circle where there is at least one day a year where the sun does not rise, and one where it does
+     *         not set, a `null` will be returned.
+     */
+    sofZmanTfilaBaalHatanya() {
+        return this.getShaahZmanisBaalHatanya(4);
+    }
+    /**
+     * This method returns the time of _mincha gedola_. _Mincha gedola_ is the earliest time one can pray
+     * _mincha_. The <a href="https://en.wikipedia.org/wiki/Maimonides">Rambam</a> is of the opinion that it is
+     * better to delay _mincha_ until {@link minchaKetanaBaalHatanya() _mincha ketana_} while the
+     * <a href="https://en.wikipedia.org/wiki/Asher_ben_Jehiel">Ra"sh</a>,
+     * <a href="https://en.wikipedia.org/wiki/Jacob_ben_Asher">Tur</a>, <a href=
+     * "https://en.wikipedia.org/wiki/Vilna_Gaon">GRA</a> and others are of the opinion that _mincha_ can be prayed
+     * _lechatchila_ starting at _mincha gedola_. This is calculated as 6.5 {@link getShaahZmanisBaalHatanya()
+     * sea level solar hours} after {@link getSunriseBaalHatanya() _netz amiti_ (sunrise)}. This calculation is based
+     * on the opinion of the Baal Hatanya that the day is calculated from sunrise to sunset. This returns the time 6.5
+     * * {@link getShaahZmanisBaalHatanya()} after {@link getSunriseBaalHatanya() _netz amiti_ ("real" sunrise)}.
+     * @return the <code>Date</code> of the time of _mincha gedola_ according to the Baal Hatanya. If the calculation
+     *         can't be computed such as in the Arctic Circle where there is at least one day a year where the sun does not rise,
+     *         and one where it does not set, a `null` will be returned.
+     */
+    minchaGedolaBaalHatanya() {
+        return this.getShaahZmanisBaalHatanya(6.5);
+    }
+    /**
+     * This method returns the time of _mincha ketana_. This is the preferred earliest time to pray
+     * _mincha_ in the opinion of the <a href="https://en.wikipedia.org/wiki/Maimonides">Rambam</a> and others.
+     * For more information on this see the documentation on {@link minchaGedolaBaalHatanya() _mincha gedola_}.
+     * This is calculated as 9.5 sea level solar hours after {@link getSunriseBaalHatanya
+     * _netz amiti_ (sunrise)}. This calculation is calculated based on the opinion of the Baal Hatanya that the
+     * day is calculated from sunrise to sunset. This returns the time 9.5 * after
+     * _netz amiti_ (sunrise).
+     *
+     * @return the <code>Date</code> of the time of _mincha ketana_. If the calculation can't be computed such as
+     *         in the Arctic Circle where there is at least one day a year where the sun does not rise, and one where it
+     *         does not set, a `null` will be returned.
+     */
+    minchaKetanaBaalHatanya() {
+        return this.getShaahZmanisBaalHatanya(9.5);
+    }
+    /**
+     * This method returns the time of _plag hamincha_. This is calculated as 10.75 hours after sunrise. This
+     * calculation is based on the opinion of the Baal Hatanya that the day is calculated
+     * from sunrise to sunset. This returns the time 10.75 * {@link getShaahZmanisBaalHatanya()} after
+     * {@link getSunriseBaalHatanya() _netz amiti_ (sunrise)}.
+     *
+     * @return the <code>Date</code> of the time of _plag hamincha_. If the calculation can't be computed such as
+     *         in the Arctic Circle where there is at least one day a year where the sun does not rise, and one where it
+     *         does not set, a `null` will be returned.
+     */
+    plagHaminchaBaalHatanya() {
+        return this.getShaahZmanisBaalHatanya(10.75);
+    }
+    /**
+     * A method that returns _tzais_ (nightfall) when the sun is 6&deg; below the western geometric horizon
+     * (90&deg;) after {@link getSunset() sunset}. For information on the source of this calculation see
+     * {@link ZENITH_6_DEGREES}.
+     *
+     * @return The <code>Date</code> of nightfall. If the calculation can't be computed such as northern and southern
+     *         locations even south of the Arctic Circle and north of the Antarctic Circle where the sun may not reach
+     *         low enough below the horizon for this calculation, a `null` will be returned.   * @see ZENITH_6_DEGREES
+     */
+    tzaisBaalHatanya() {
+        return this.timeAtAngle(6, false);
+    }
     /**
      * Uses timeFormat to return a date like '20:34'.
      * Returns `XX:XX` if the date is invalid.

package/dist/version.js

@@ -1,5 +1,4 @@
-/* eslint-disable require-jsdoc */
-import fs from 'fs';
+import fs from 'node:fs';
 const inpath = process.argv[2];
 const outpath = process.argv[3];
 const contents = fs.readFileSync(inpath).toString();

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@hebcal/core",
-  "version": "6.0.8",
+  "version": "6.2.0",
   "author": "Michael J. Radwin (https://github.com/mjradwin)",
   "contributors": [
     "Eyal Schachter (https://github.com/Scimonster)",
     "Danny Sadinoff (https://github.com/dsadinoff)",
+    "Eliyahu Hershfeld (https://github.com/KosherJava)",
     "Yisroel Yakovson (https://github.com/YizYah)",
     "Schabse Laks (https://github.com/SLaks)",
     "Benny Powers (https://github.com/bennypowers)"
@@ -49,7 +50,7 @@
   ],
   "scripts": {
     "build:rollup": "rollup -c",
-    "size-demo:rollup": "rollup -c size-demo/rollup.config.ts --configPlugin typescript",
+    "size-demo:rollup": "rollup -c size-demo/rollup.config.js",
     "size-demo": "npm run build && npm run size-demo:rollup",
     "build": "npm run po2json && npm run version && npm run build:rollup --production",
     "prepublish": "npm run build",
@@ -63,32 +64,29 @@
     "clean": "gts clean",
     "fix": "gts fix",
     "compile": "tsc",
-    "prepare": "npm run compile",
-    "posttest": "npm run lint"
+    "prepare": "npm run compile"
   },
   "license": "GPL-2.0",
   "devDependencies": {
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-terser": "^1.0.0",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@types/node": "^25.0.3",
-    "@vitest/coverage-v8": "^4.0.16",
-    "core-js": "^3.47.0",
-    "gettext-parser": "^9.0.0",
-    "gts": "^6.0.2",
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.4",
+    "gettext-parser": "^9.0.2",
+    "gts": "^7.0.0",
     "pretty-bytes": "^7.1.0",
-    "rollup": "^4.54.0",
+    "rollup": "^4.60.1",
     "rollup-plugin-bundle-size": "^1.0.3",
-    "rollup-plugin-visualizer": "^6.0.5",
-    "typedoc": "^0.28.15",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.16"
+    "rollup-plugin-visualizer": "^7.0.1",
+    "typedoc": "^0.28.18",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4"
   },
   "dependencies": {
-    "@hebcal/hdate": "^0.21.1",
-    "@hebcal/noaa": "^0.9.2",
+    "@hebcal/hdate": "^0.22.0",
+    "@hebcal/noaa": "^0.10.1",
     "quick-lru": "^7.3.0",
-    "temporal-polyfill": "^0.3.0",
-    "tslib": "^2.8.1"
+    "temporal-polyfill": "^0.3.2"
   }
 }