@hebcal/core 5.3.6 → 5.3.8

package/dist/index.cjs

@@ -1,4 +1,4 @@
-/*! @hebcal/core v5.3.6 */
+/*! @hebcal/core v5.3.8 */
 'use strict';
 
 /* eslint-disable @typescript-eslint/no-namespace, no-inner-declarations */
@@ -7813,6 +7813,21 @@ class Zmanim {
     this.noaa = new NOAACalculator(gloc, plainDate);
     this.useElevation = Boolean(useElevation);
   }
+  /**
+   * Returns `true` if elevation adjustment is enabled
+   * for zmanim support elevation adjustment
+   * @return {boolean}
+   */
+  getUseElevation() {
+    return this.useElevation;
+  }
+  /**
+   * Enables or disables elevation adjustment for zmanim support elevation adjustment
+   * @param {boolean} useElevation
+   */
+  setUseElevation(useElevation) {
+    this.useElevation = useElevation;
+  }
   /**
    * Convenience function to get the time when sun is above or below the horizon
    * for a certain angle (in degrees).
@@ -7930,8 +7945,8 @@ class Zmanim {
    * @return {Date}
    */
   getShaahZmanisBasedZman(hours) {
-    const startOfDay = this.noaa.getSunrise();
-    const endOfDay = this.noaa.getSunset();
+    const startOfDay = this.useElevation ? this.noaa.getSunrise() : this.noaa.getSeaLevelSunrise();
+    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);
@@ -7967,13 +7982,14 @@ class Zmanim {
   /**
    * Returns an array with alot (Date) and ms in hour (number)
    * @private
+   * @param {number} angle
    * @return {any[]}
    */
-  getTemporalHour16Point1() {
-    const alot16one = this.alotHaShachar();
-    const tzeit16one = this.tzeit(16.1);
-    const temporalHour = (tzeit16one - alot16one) / 12;
-    return [alot16one, temporalHour];
+  getTemporalHourByDeg(angle) {
+    const alot = this.timeAtAngle(angle, true);
+    const tzeit = this.timeAtAngle(angle, false);
+    const temporalHour = (tzeit - alot) / 12;
+    return [alot, temporalHour];
   }
   /**
    * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
@@ -7994,7 +8010,21 @@ class Zmanim {
    * @return {Date}
    */
   sofZmanShmaMGA16Point1() {
-    const [alot, temporalHour] = this.getTemporalHour16Point1();
+    const [alot, temporalHour] = this.getTemporalHourByDeg(16.1);
+    return new Date(alot.getTime() + 3 * temporalHour);
+  }
+  /**
+   * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
+   * Based on the opinion of the MGA that the day is calculated from
+   * dawn to nightfall with both being 19.8° below the horizon.
+   *
+   * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
+   * around the equinox / equilux which calculates to 19.8° below geometric zenith.
+   * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
+   * @return {Date}
+   */
+  sofZmanShmaMGA19Point8() {
+    const [alot, temporalHour] = this.getTemporalHourByDeg(19.8);
     return new Date(alot.getTime() + 3 * temporalHour);
   }
   /**
@@ -8013,7 +8043,21 @@ class Zmanim {
    * @return {Date}
    */
   sofZmanTfillaMGA16Point1() {
-    const [alot, temporalHour] = this.getTemporalHour16Point1();
+    const [alot, temporalHour] = this.getTemporalHourByDeg(16.1);
+    return new Date(alot.getTime() + 4 * temporalHour);
+  }
+  /**
+   * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
+   * Based on the opinion of the MGA that the day is calculated from
+   * dawn to nightfall with both being 19.8° below the horizon.
+   *
+   * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
+   * around the equinox / equilux which calculates to 19.8° below geometric zenith.
+   * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
+   * @return {Date}
+   */
+  sofZmanTfillaMGA19Point8() {
+    const [alot, temporalHour] = this.getTemporalHourByDeg(19.8);
     return new Date(alot.getTime() + 4 * temporalHour);
   }
   /**
@@ -10458,7 +10502,7 @@ class DailyLearning {
 }
 
 // DO NOT EDIT THIS AUTO-GENERATED FILE!
-const version = '5.3.6';
+const version = '5.3.8';
 
 const NONE$1 = 0;
 const HALF = 1;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-/*! @hebcal/core v5.3.6 */
+/*! @hebcal/core v5.3.8 */
 /* eslint-disable @typescript-eslint/no-namespace, no-inner-declarations */
 /** @private */
 const lengths = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
@@ -7811,6 +7811,21 @@ class Zmanim {
     this.noaa = new NOAACalculator(gloc, plainDate);
     this.useElevation = Boolean(useElevation);
   }
+  /**
+   * Returns `true` if elevation adjustment is enabled
+   * for zmanim support elevation adjustment
+   * @return {boolean}
+   */
+  getUseElevation() {
+    return this.useElevation;
+  }
+  /**
+   * Enables or disables elevation adjustment for zmanim support elevation adjustment
+   * @param {boolean} useElevation
+   */
+  setUseElevation(useElevation) {
+    this.useElevation = useElevation;
+  }
   /**
    * Convenience function to get the time when sun is above or below the horizon
    * for a certain angle (in degrees).
@@ -7928,8 +7943,8 @@ class Zmanim {
    * @return {Date}
    */
   getShaahZmanisBasedZman(hours) {
-    const startOfDay = this.noaa.getSunrise();
-    const endOfDay = this.noaa.getSunset();
+    const startOfDay = this.useElevation ? this.noaa.getSunrise() : this.noaa.getSeaLevelSunrise();
+    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);
@@ -7965,13 +7980,14 @@ class Zmanim {
   /**
    * Returns an array with alot (Date) and ms in hour (number)
    * @private
+   * @param {number} angle
    * @return {any[]}
    */
-  getTemporalHour16Point1() {
-    const alot16one = this.alotHaShachar();
-    const tzeit16one = this.tzeit(16.1);
-    const temporalHour = (tzeit16one - alot16one) / 12;
-    return [alot16one, temporalHour];
+  getTemporalHourByDeg(angle) {
+    const alot = this.timeAtAngle(angle, true);
+    const tzeit = this.timeAtAngle(angle, false);
+    const temporalHour = (tzeit - alot) / 12;
+    return [alot, temporalHour];
   }
   /**
    * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
@@ -7992,7 +8008,21 @@ class Zmanim {
    * @return {Date}
    */
   sofZmanShmaMGA16Point1() {
-    const [alot, temporalHour] = this.getTemporalHour16Point1();
+    const [alot, temporalHour] = this.getTemporalHourByDeg(16.1);
+    return new Date(alot.getTime() + 3 * temporalHour);
+  }
+  /**
+   * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
+   * Based on the opinion of the MGA that the day is calculated from
+   * dawn to nightfall with both being 19.8° below the horizon.
+   *
+   * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
+   * around the equinox / equilux which calculates to 19.8° below geometric zenith.
+   * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
+   * @return {Date}
+   */
+  sofZmanShmaMGA19Point8() {
+    const [alot, temporalHour] = this.getTemporalHourByDeg(19.8);
     return new Date(alot.getTime() + 3 * temporalHour);
   }
   /**
@@ -8011,7 +8041,21 @@ class Zmanim {
    * @return {Date}
    */
   sofZmanTfillaMGA16Point1() {
-    const [alot, temporalHour] = this.getTemporalHour16Point1();
+    const [alot, temporalHour] = this.getTemporalHourByDeg(16.1);
+    return new Date(alot.getTime() + 4 * temporalHour);
+  }
+  /**
+   * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
+   * Based on the opinion of the MGA that the day is calculated from
+   * dawn to nightfall with both being 19.8° below the horizon.
+   *
+   * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
+   * around the equinox / equilux which calculates to 19.8° below geometric zenith.
+   * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
+   * @return {Date}
+   */
+  sofZmanTfillaMGA19Point8() {
+    const [alot, temporalHour] = this.getTemporalHourByDeg(19.8);
     return new Date(alot.getTime() + 4 * temporalHour);
   }
   /**
@@ -10456,7 +10500,7 @@ class DailyLearning {
 }
 
 // DO NOT EDIT THIS AUTO-GENERATED FILE!
-const version = '5.3.6';
+const version = '5.3.8';
 
 const NONE$1 = 0;
 const HALF = 1;

package/hebcal.d.ts

@@ -420,6 +420,15 @@ declare module '@hebcal/core' {
          *    These zmanim intentionally do not support elevation adjustment.
          */
         constructor(gloc: GeoLocation, date: Date | HDate, useElevation?: boolean);
+        /**
+         * Returns `true` if elevation adjustment is enabled
+         * for zmanim support elevation adjustment
+         */
+        getUseElevation(): boolean;
+        /**
+         * Enables or disables elevation adjustment for zmanim support elevation adjustment
+         */
+        setUseElevation(useElevation: boolean): void;
 
         /**
          * Returns a string like "2022-04-01T13:06:00-11:00"
@@ -484,15 +493,35 @@ declare module '@hebcal/core' {
          * dawn to nightfall with both being 16.1° below the horizon.
          */
         sofZmanShmaMGA16Point1(): Date;
+        /**
+         * Latest Shema (MGA); Sunrise plus 3 halachic hours, according to Magen Avraham.
+         * Based on the opinion of the MGA that the day is calculated from
+         * dawn to nightfall with both being 19.8° below the horizon.
+         *
+         * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
+         * around the equinox / equilux which calculates to 19.8° below geometric zenith.
+         * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
+         */
+        sofZmanShmaMGA19Point8(): Date;
         /** Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham */
         sofZmanTfillaMGA(): Date;
-        /** Earliest Mincha – Mincha Gedola; Sunrise plus 6.5 halachic hours */
         /**
          * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
          * Based on the opinion of the MGA that the day is calculated from
          * dawn to nightfall with both being 16.1° below the horizon.
          */
         sofZmanTfillaMGA16Point1(): Date;
+        /**
+         * Latest Shacharit (MGA); Sunrise plus 4 halachic hours, according to Magen Avraham.
+         * Based on the opinion of the MGA that the day is calculated from
+         * dawn to nightfall with both being 19.8° below the horizon.
+         *
+         * This calculation is based on the position of the sun 90 minutes after sunset in Jerusalem
+         * around the equinox / equilux which calculates to 19.8° below geometric zenith.
+         * https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/
+         */
+        sofZmanTfillaMGA19Point8(): Date;
+        /** Earliest Mincha – Mincha Gedola; Sunrise plus 6.5 halachic hours */
         minchaGedola(): Date;
         /** Preferable earliest time to recite Minchah – Mincha Ketana; Sunrise plus 9.5 halachic hours */
         minchaKetana(): Date;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hebcal/core",
-  "version": "5.3.6",
+  "version": "5.3.8",
   "author": "Michael J. Radwin (https://github.com/mjradwin)",
   "contributors": [
     "Eyal Schachter (https://github.com/Scimonster)",