@hebcal/core 5.0.0 → 5.0.2

package/dist/bundle.js

@@ -1,457 +1,112 @@
-/*! @hebcal/core v5.0.0 */
+/*! @hebcal/core v5.0.2 */
 var hebcal = (function (exports) {
 'use strict';
 
-const GERESH = '׳';
-const GERSHAYIM = '״';
-const heb2num = {
-  'א': 1,
-  'ב': 2,
-  'ג': 3,
-  'ד': 4,
-  'ה': 5,
-  'ו': 6,
-  'ז': 7,
-  'ח': 8,
-  'ט': 9,
-  'י': 10,
-  'כ': 20,
-  'ל': 30,
-  'מ': 40,
-  'נ': 50,
-  'ס': 60,
-  'ע': 70,
-  'פ': 80,
-  'צ': 90,
-  'ק': 100,
-  'ר': 200,
-  'ש': 300,
-  'ת': 400
-};
-const num2heb = new Map();
-Object.keys(heb2num).forEach(key => {
-  const val = heb2num[key];
-  num2heb.set(val, key);
-});
-
+/** @private */
+const lengths = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+/** @private */
+const monthLengths = [lengths, lengths.slice()];
+monthLengths[1][2] = 29;
 /**
  * @private
- * @param {number} num
- * @return {number[]}
  */
-function num2digits(num) {
-  const digits = [];
-  while (num > 0) {
-    if (num === 15 || num === 16) {
-      digits.push(9);
-      digits.push(num - 9);
-      break;
-    }
-    let incr = 100;
-    let i;
-    for (i = 400; i > num; i -= incr) {
-      if (i === incr) {
-        incr = incr / 10;
-      }
-    }
-    digits.push(i);
-    num -= i;
-  }
-  return digits;
+function mod$1(x, y) {
+  return x - y * Math.floor(x / y);
 }
-
 /**
- * Converts a numerical value to a string of Hebrew letters.
- *
- * When specifying years of the Hebrew calendar in the present millennium,
- * we omit the thousands (which is presently 5 [ה]).
- * @example
- * gematriya(5774) // 'תשע״ד' - cropped to 774
- * gematriya(25) // 'כ״ה'
- * gematriya(60) // 'ס׳'
- * gematriya(3761) // 'ג׳תשס״א'
- * gematriya(1123) // 'א׳קכ״ג'
- * @param {number} number
- * @return {string}
+ * @private
  */
-function gematriya(number) {
-  const num = parseInt(number, 10);
-  if (!num) {
-    throw new TypeError(`invalid parameter to gematriya ${number}`);
-  }
-  let str = '';
-  const thousands = Math.floor(num / 1000);
-  if (thousands > 0 && thousands !== 5) {
-    const tdigits = num2digits(thousands);
-    for (const tdig of tdigits) {
-      str += num2heb.get(tdig);
-    }
-    str += GERESH;
-  }
-  const digits = num2digits(num % 1000);
-  if (digits.length == 1) {
-    return str + num2heb.get(digits[0]) + GERESH;
-  }
-  for (let i = 0; i < digits.length; i++) {
-    if (i + 1 === digits.length) {
-      str += GERSHAYIM;
-    }
-    str += num2heb.get(digits[i]);
-  }
-  return str;
+function quotient(x, y) {
+  return Math.floor(x / y);
 }
-
+/*
+const ABS_14SEP1752 = 639797;
+const ABS_2SEP1752 = 639785;
+*/
 /**
- * Converts a string of Hebrew letters to a numerical value.
- *
- * Only considers the value of Hebrew letters `א` through `ת`.
- * Ignores final Hebrew letters such as `ך` (kaf sofit) or `ם` (mem sofit)
- * and vowels (nekudot).
- *
- * @param {string} str
- * @return {number}
+ * Gregorian date helper functions.
  */
-function gematriyaStrToNum(str) {
-  let num = 0;
-  const gereshIdx = str.indexOf(GERESH);
-  if (gereshIdx !== -1 && gereshIdx !== str.length - 1) {
-    const thousands = str.substring(0, gereshIdx);
-    num += gematriyaStrToNum(thousands) * 1000;
-    str = str.substring(gereshIdx);
+exports.greg = void 0;
+(function (greg) {
+  /**
+   * Long names of the Gregorian months (1='January', 12='December')
+   * @readonly
+   * @type {string[]}
+   */
+  greg.monthNames = ['', 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
+  /**
+   * Returns true if the Gregorian year is a leap year
+   * @param {number} year Gregorian year
+   * @return {boolean}
+   */
+  function isLeapYear(year) {
+    return !(year % 4) && (!!(year % 100) || !(year % 400));
   }
-  for (const ch of str) {
-    const n = heb2num[ch];
-    if (typeof n === 'number') {
-      num += n;
-    }
+  greg.isLeapYear = isLeapYear;
+  /**
+   * Number of days in the Gregorian month for given year
+   * @param {number} month Gregorian month (1=January, 12=December)
+   * @param {number} year Gregorian year
+   * @return {number}
+   */
+  function daysInMonth(month, year) {
+    // 1 based months
+    return monthLengths[+isLeapYear(year)][month];
   }
-  return num;
-}
-
-const noopLocale = {
-  headers: {
-    'plural-forms': 'nplurals=2; plural=(n!=1);'
-  },
-  contexts: {
-    '': {}
+  greg.daysInMonth = daysInMonth;
+  /**
+   * Returns true if the object is a Javascript Date
+   * @param {Object} obj
+   * @return {boolean}
+   */
+  function isDate(obj) {
+    return typeof obj === 'object' && Date.prototype.isPrototypeOf(obj);
   }
-};
-const alias = {
-  'h': 'he',
-  'a': 'ashkenazi',
-  's': 'en',
-  '': 'en'
-};
-
-/** @private */
-const locales = new Map();
-/** @private */
-let activeLocale = null;
-/** @private */
-let activeName = null;
-
-/**
- * A locale in Hebcal is used for translations/transliterations of
- * holidays. `@hebcal/core` supports four locales by default
- * * `en` - default, Sephardic transliterations (e.g. "Shabbat")
- * * `ashkenazi` - Ashkenazi transliterations (e.g. "Shabbos")
- * * `he` - Hebrew (e.g. "שַׁבָּת")
- * * `he-x-NoNikud` - Hebrew without nikud (e.g. "שבת")
- */
-class Locale {
+  greg.isDate = isDate;
   /**
-   * Returns translation only if `locale` offers a non-empty translation for `id`.
-   * Otherwise, returns `undefined`.
-   * @param {string} id Message ID to translate
-   * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
-   * @return {string}
+   * @private
+   * @param abs - R.D. number of days
    */
-  static lookupTranslation(id, locale) {
-    const locale0 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
-    const loc = typeof locale == 'string' && locales.get(locale0) || activeLocale;
-    const array = loc[id];
-    if (array && array.length && array[0].length) {
-      return array[0];
-    }
-    return undefined;
+  function yearFromFixed(abs) {
+    const l0 = abs - 1;
+    const n400 = quotient(l0, 146097);
+    const d1 = mod$1(l0, 146097);
+    const n100 = quotient(d1, 36524);
+    const d2 = mod$1(d1, 36524);
+    const n4 = quotient(d2, 1461);
+    const d3 = mod$1(d2, 1461);
+    const n1 = quotient(d3, 365);
+    const year = 400 * n400 + 100 * n100 + 4 * n4 + n1;
+    return n100 != 4 && n1 != 4 ? year + 1 : year;
   }
-
   /**
-   * By default, if no translation was found, returns `id`.
-   * @param {string} id Message ID to translate
-   * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
-   * @return {string}
+   * @private
+   * @param year
+   * @param month (1-12)
+   * @param day (1-31)
    */
-  static gettext(id, locale) {
-    const text = this.lookupTranslation(id, locale);
-    if (typeof text == 'undefined') {
-      return id;
-    }
-    return text;
+  function toFixed(year, month, day) {
+    const py = year - 1;
+    return 365 * py + quotient(py, 4) - quotient(py, 100) + quotient(py, 400) + quotient(367 * month - 362, 12) + (month <= 2 ? 0 : isLeapYear(year) ? -1 : -2) + day;
   }
-
   /**
-   * Register locale translations.
-   * @param {string} locale Locale name (i.e.: `'he'`, `'fr'`)
-   * @param {LocaleData} data parsed data from a `.po` file.
+   * Converts Gregorian date to absolute R.D. (Rata Die) days
+   * @param {Date} date Gregorian date
+   * @return {number}
    */
-  static addLocale(locale, data) {
-    if (typeof locale !== 'string') {
-      throw new TypeError(`Invalid locale name: ${locale}`);
+  function greg2abs(date) {
+    if (!isDate(date)) {
+      throw new TypeError(`Argument not a Date: ${date}`);
     }
-    if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
-      throw new TypeError(`Locale '${locale}' invalid compact format`);
+    const abs = toFixed(date.getFullYear(), date.getMonth() + 1, date.getDate());
+    /*
+    if (abs < ABS_14SEP1752 && abs > ABS_2SEP1752) {
+      throw new RangeError(`Invalid Date: ${date}`);
     }
-    locales.set(locale.toLowerCase(), data.contexts['']);
+    */
+    return abs;
   }
-
-  /**
-   * Adds a translation to `locale`, replacing any previous translation.
-   * @param {string} locale Locale name (i.e: `'he'`, `'fr'`).
-   * @param {string} id Message ID to translate
-   * @param {string} translation Translation text
-   */
-  static addTranslation(locale, id, translation) {
-    if (typeof locale !== 'string') {
-      throw new TypeError(`Invalid locale name: ${locale}`);
-    }
-    const locale0 = locale.toLowerCase();
-    const loc = locales.get(locale0);
-    if (!loc) {
-      throw new TypeError(`Unknown locale: ${locale}`);
-    }
-    if (typeof id !== 'string' || id.length === 0) {
-      throw new TypeError(`Invalid id: ${id}`);
-    }
-    const isArray = Array.isArray(translation);
-    if (isArray) {
-      const t0 = translation[0];
-      if (typeof t0 !== 'string' || t0.length === 0) {
-        throw new TypeError(`Invalid translation array: ${translation}`);
-      }
-    } else if (typeof translation !== 'string') {
-      throw new TypeError(`Invalid translation: ${translation}`);
-    }
-    loc[id] = isArray ? translation : [translation];
-  }
-  /**
-   * Adds multiple translations to `locale`, replacing any previous translations.
-   * @param {string} locale Locale name (i.e: `'he'`, `'fr'`).
-   * @param {LocaleData} data parsed data from a `.po` file.
-   */
-  static addTranslations(locale, data) {
-    if (typeof locale !== 'string') {
-      throw new TypeError(`Invalid locale name: ${locale}`);
-    }
-    const locale0 = locale.toLowerCase();
-    const loc = locales.get(locale0);
-    if (!loc) {
-      throw new TypeError(`Unknown locale: ${locale}`);
-    }
-    if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
-      throw new TypeError(`Locale '${locale}' invalid compact format`);
-    }
-    const ctx = data.contexts[''];
-    Object.keys(ctx).forEach(id => {
-      loc[id] = ctx[id];
-    });
-  }
-  /**
-   * Activates a locale. Throws an error if the locale has not been previously added.
-   * After setting the locale to be used, all strings marked for translations
-   * will be represented by the corresponding translation in the specified locale.
-   * @param {string} locale Locale name (i.e: `'he'`, `'fr'`)
-   * @return {LocaleData}
-   */
-  static useLocale(locale) {
-    const locale0 = locale.toLowerCase();
-    const obj = locales.get(locale0);
-    if (!obj) {
-      throw new RangeError(`Locale '${locale}' not found`);
-    }
-    activeName = alias[locale0] || locale0;
-    activeLocale = obj;
-    return activeLocale;
-  }
-
-  /**
-   * Returns the name of the active locale (i.e. 'he', 'ashkenazi', 'fr')
-   * @return {string}
-   */
-  static getLocaleName() {
-    return activeName;
-  }
-
-  /**
-   * Returns the names of registered locales
-   * @return {string[]}
-   */
-  static getLocaleNames() {
-    const keys = Array.from(locales.keys());
-    return keys.sort((a, b) => a.localeCompare(b));
-  }
-
-  /**
-   * @param {number} n
-   * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
-   * @return {string}
-   */
-  static ordinal(n, locale) {
-    const locale1 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
-    const locale0 = locale1 || activeName;
-    if (!locale0) {
-      return this.getEnOrdinal(n);
-    }
-    switch (locale0) {
-      case 'en':
-      case 's':
-      case 'a':
-      case 'ashkenazi':
-      case 'ashkenazi_litvish':
-      case 'ashkenazi_poylish':
-      case 'ashkenazi_standard':
-        return this.getEnOrdinal(n);
-      case 'es':
-        return n + 'º';
-      case 'h':
-      case 'he':
-      case 'he-x-nonikud':
-        return String(n);
-      default:
-        return n + '.';
-    }
-  }
-
-  /**
-   * @private
-   * @param {number} n
-   * @return {string}
-   */
-  static getEnOrdinal(n) {
-    const s = ['th', 'st', 'nd', 'rd'];
-    const v = n % 100;
-    return n + (s[(v - 20) % 10] || s[v] || s[0]);
-  }
-
-  /**
-   * Removes nekudot from Hebrew string
-   * @param {string} str
-   * @return {string}
-   */
-  static hebrewStripNikkud(str) {
-    return str.replace(/[\u0590-\u05bd]/g, '').replace(/[\u05bf-\u05c7]/g, '');
-  }
-}
-Locale.addLocale('en', noopLocale);
-Locale.addLocale('s', noopLocale);
-Locale.addLocale('', noopLocale);
-Locale.useLocale('en');
-
-/** @private */
-const lengths = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
-/** @private */
-const monthLengths = [lengths, lengths.slice()];
-monthLengths[1][2] = 29;
-/**
- * @private
- */
-function mod$1(x, y) {
-  return x - y * Math.floor(x / y);
-}
-/**
- * @private
- */
-function quotient(x, y) {
-  return Math.floor(x / y);
-}
-/*
-const ABS_14SEP1752 = 639797;
-const ABS_2SEP1752 = 639785;
-*/
-/**
- * Gregorian date helper functions.
- */
-exports.greg = void 0;
-(function (greg) {
-  /**
-   * Long names of the Gregorian months (1='January', 12='December')
-   * @readonly
-   * @type {string[]}
-   */
-  greg.monthNames = ['', 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
-  /**
-   * Returns true if the Gregorian year is a leap year
-   * @param {number} year Gregorian year
-   * @return {boolean}
-   */
-  function isLeapYear(year) {
-    return !(year % 4) && (!!(year % 100) || !(year % 400));
-  }
-  greg.isLeapYear = isLeapYear;
-  /**
-   * Number of days in the Gregorian month for given year
-   * @param {number} month Gregorian month (1=January, 12=December)
-   * @param {number} year Gregorian year
-   * @return {number}
-   */
-  function daysInMonth(month, year) {
-    // 1 based months
-    return monthLengths[+isLeapYear(year)][month];
-  }
-  greg.daysInMonth = daysInMonth;
-  /**
-   * Returns true if the object is a Javascript Date
-   * @param {Object} obj
-   * @return {boolean}
-   */
-  function isDate(obj) {
-    return typeof obj === 'object' && Date.prototype.isPrototypeOf(obj);
-  }
-  greg.isDate = isDate;
-  /**
-   * @private
-   * @param abs - R.D. number of days
-   */
-  function yearFromFixed(abs) {
-    const l0 = abs - 1;
-    const n400 = quotient(l0, 146097);
-    const d1 = mod$1(l0, 146097);
-    const n100 = quotient(d1, 36524);
-    const d2 = mod$1(d1, 36524);
-    const n4 = quotient(d2, 1461);
-    const d3 = mod$1(d2, 1461);
-    const n1 = quotient(d3, 365);
-    const year = 400 * n400 + 100 * n100 + 4 * n4 + n1;
-    return n100 != 4 && n1 != 4 ? year + 1 : year;
-  }
-  /**
-   * @private
-   * @param year
-   * @param month (1-12)
-   * @param day (1-31)
-   */
-  function toFixed(year, month, day) {
-    const py = year - 1;
-    return 365 * py + quotient(py, 4) - quotient(py, 100) + quotient(py, 400) + quotient(367 * month - 362, 12) + (month <= 2 ? 0 : isLeapYear(year) ? -1 : -2) + day;
-  }
-  /**
-   * Converts Gregorian date to absolute R.D. (Rata Die) days
-   * @param {Date} date Gregorian date
-   * @return {number}
-   */
-  function greg2abs(date) {
-    if (!isDate(date)) {
-      throw new TypeError(`Argument not a Date: ${date}`);
-    }
-    const abs = toFixed(date.getFullYear(), date.getMonth() + 1, date.getDate());
-    /*
-    if (abs < ABS_14SEP1752 && abs > ABS_2SEP1752) {
-      throw new RangeError(`Invalid Date: ${date}`);
-    }
-    */
-    return abs;
-  }
-  greg.greg2abs = greg2abs;
+  greg.greg2abs = greg2abs;
   /**
    * Converts from Rata Die (R.D. number) to Gregorian date.
    * See the footnote on page 384 of ``Calendrical Calculations, Part II:
@@ -850,106 +505,443 @@ function monthFromName(monthName) {
         case 'ש':
           return months.TISHREI;
       }
-      break;
+      break;
+  }
+  throw new RangeError(`Unable to parse month name: ${monthName}`);
+}
+
+const NISAN$3 = months.NISAN;
+const CHESHVAN = months.CHESHVAN;
+const KISLEV$1 = months.KISLEV;
+const TEVET$1 = months.TEVET;
+const SHVAT = months.SHVAT;
+const ADAR_I$1 = months.ADAR_I;
+const ADAR_II = months.ADAR_II;
+/**
+ * Returns true if the object is a Javascript Date
+ * @private
+ * @param {Object} obj
+ */
+function isSimpleHebrewDate(obj) {
+  return typeof obj === 'object' && obj !== null && typeof obj.yy === 'number' && typeof obj.mm === 'number' && typeof obj.dd === 'number';
+}
+/**
+ * @private
+ */
+function toSimpleHebrewDate(obj) {
+  if (isSimpleHebrewDate(obj)) {
+    return obj;
+  } else if (typeof obj === 'number') {
+    return abs2hebrew(obj);
+  } else if (exports.greg.isDate(obj)) {
+    const abs = exports.greg.greg2abs(obj);
+    return abs2hebrew(abs);
+  } else {
+    throw new TypeError(`Argument not a Date: ${obj}`);
+  }
+}
+function getYahrzeitHD(hyear, date) {
+  let hDeath = toSimpleHebrewDate(date);
+  if (hyear <= hDeath.yy) {
+    // Hebrew year ${hyear} occurs on or before original date in ${hDeath.yy}
+    return undefined;
+  }
+  if (hDeath.mm == CHESHVAN && hDeath.dd == 30 && !longCheshvan(hDeath.yy + 1)) {
+    // If it's Heshvan 30 it depends on the first anniversary;
+    // if that was not Heshvan 30, use the day before Kislev 1.
+    hDeath = abs2hebrew(hebrew2abs(hyear, KISLEV$1, 1) - 1);
+  } else if (hDeath.mm == KISLEV$1 && hDeath.dd == 30 && shortKislev(hDeath.yy + 1)) {
+    // If it's Kislev 30 it depends on the first anniversary;
+    // if that was not Kislev 30, use the day before Teveth 1.
+    hDeath = abs2hebrew(hebrew2abs(hyear, TEVET$1, 1) - 1);
+  } else if (hDeath.mm == ADAR_II) {
+    // If it's Adar II, use the same day in last month of year (Adar or Adar II).
+    hDeath.mm = monthsInYear(hyear);
+  } else if (hDeath.mm == ADAR_I$1 && hDeath.dd == 30 && !isLeapYear(hyear)) {
+    // If it's the 30th in Adar I and year is not a leap year
+    // (so Adar has only 29 days), use the last day in Shevat.
+    hDeath.dd = 30;
+    hDeath.mm = SHVAT;
+  }
+  // In all other cases, use the normal anniversary of the date of death.
+  // advance day to rosh chodesh if needed
+  if (hDeath.mm == CHESHVAN && hDeath.dd == 30 && !longCheshvan(hyear)) {
+    hDeath.mm = KISLEV$1;
+    hDeath.dd = 1;
+  } else if (hDeath.mm == KISLEV$1 && hDeath.dd == 30 && shortKislev(hyear)) {
+    hDeath.mm = TEVET$1;
+    hDeath.dd = 1;
+  }
+  hDeath.yy = hyear;
+  return hDeath;
+}
+function getBirthdayHD(hyear, date) {
+  const orig = toSimpleHebrewDate(date);
+  const origYear = orig.yy;
+  if (hyear === origYear) {
+    return orig;
+  } else if (hyear < origYear) {
+    // Hebrew year ${hyear} occurs on or before original date in ${origYear}
+    return undefined;
+  }
+  const isOrigLeap = isLeapYear(origYear);
+  let month = orig.mm;
+  let day = orig.dd;
+  if (month == ADAR_I$1 && !isOrigLeap || month == ADAR_II && isOrigLeap) {
+    month = monthsInYear(hyear);
+  } else if (month == CHESHVAN && day == 30 && !longCheshvan(hyear)) {
+    month = KISLEV$1;
+    day = 1;
+  } else if (month == KISLEV$1 && day == 30 && shortKislev(hyear)) {
+    month = TEVET$1;
+    day = 1;
+  } else if (month == ADAR_I$1 && day == 30 && isOrigLeap && !isLeapYear(hyear)) {
+    month = NISAN$3;
+    day = 1;
+  }
+  return {
+    yy: hyear,
+    mm: month,
+    dd: day
+  };
+}
+
+const GERESH = '׳';
+const GERSHAYIM = '״';
+const alefbet = {
+  'א': 1,
+  'ב': 2,
+  'ג': 3,
+  'ד': 4,
+  'ה': 5,
+  'ו': 6,
+  'ז': 7,
+  'ח': 8,
+  'ט': 9,
+  'י': 10,
+  'כ': 20,
+  'ל': 30,
+  'מ': 40,
+  'נ': 50,
+  'ס': 60,
+  'ע': 70,
+  'פ': 80,
+  'צ': 90,
+  'ק': 100,
+  'ר': 200,
+  'ש': 300,
+  'ת': 400
+};
+const heb2num = new Map();
+const num2heb = new Map();
+for (const [key, val] of Object.entries(alefbet)) {
+  heb2num.set(key, val);
+  num2heb.set(val, key);
+}
+function num2digits(num) {
+  const digits = [];
+  while (num > 0) {
+    if (num === 15 || num === 16) {
+      digits.push(9);
+      digits.push(num - 9);
+      break;
+    }
+    let incr = 100;
+    let i;
+    for (i = 400; i > num; i -= incr) {
+      if (i === incr) {
+        incr = incr / 10;
+      }
+    }
+    digits.push(i);
+    num -= i;
+  }
+  return digits;
+}
+/**
+ * Converts a numerical value to a string of Hebrew letters.
+ *
+ * When specifying years of the Hebrew calendar in the present millennium,
+ * we omit the thousands (which is presently 5 [ה]).
+ * @example
+ * gematriya(5774) // 'תשע״ד' - cropped to 774
+ * gematriya(25) // 'כ״ה'
+ * gematriya(60) // 'ס׳'
+ * gematriya(3761) // 'ג׳תשס״א'
+ * gematriya(1123) // 'א׳קכ״ג'
+ * @param {number} num
+ * @return {string}
+ */
+function gematriya(num) {
+  const num0 = num;
+  const num1 = parseInt(num0, 10);
+  if (!num1) {
+    throw new TypeError(`invalid parameter to gematriya ${num}`);
+  }
+  let str = '';
+  const thousands = Math.floor(num1 / 1000);
+  if (thousands > 0 && thousands !== 5) {
+    const tdigits = num2digits(thousands);
+    for (const tdig of tdigits) {
+      str += num2heb.get(tdig);
+    }
+    str += GERESH;
+  }
+  const digits = num2digits(num1 % 1000);
+  if (digits.length == 1) {
+    return str + num2heb.get(digits[0]) + GERESH;
+  }
+  for (let i = 0; i < digits.length; i++) {
+    if (i + 1 === digits.length) {
+      str += GERSHAYIM;
+    }
+    str += num2heb.get(digits[i]);
+  }
+  return str;
+}
+/**
+ * Converts a string of Hebrew letters to a numerical value.
+ *
+ * Only considers the value of Hebrew letters `א` through `ת`.
+ * Ignores final Hebrew letters such as `ך` (kaf sofit) or `ם` (mem sofit)
+ * and vowels (nekudot).
+ *
+ * @param {string} str
+ * @return {number}
+ */
+function gematriyaStrToNum(str) {
+  let num = 0;
+  const gereshIdx = str.indexOf(GERESH);
+  if (gereshIdx !== -1 && gereshIdx !== str.length - 1) {
+    const thousands = str.substring(0, gereshIdx);
+    num += gematriyaStrToNum(thousands) * 1000;
+    str = str.substring(gereshIdx);
+  }
+  for (const ch of str) {
+    const n = heb2num.get(ch);
+    if (typeof n === 'number') {
+      num += n;
+    }
+  }
+  return num;
+}
+
+const noopLocale = {
+  headers: {
+    'plural-forms': 'nplurals=2; plural=(n!=1);'
+  },
+  contexts: {
+    '': {}
+  }
+};
+const alias = {
+  'h': 'he',
+  'a': 'ashkenazi',
+  's': 'en',
+  '': 'en'
+};
+
+/** @private */
+const locales = new Map();
+/** @private */
+let activeLocale = null;
+/** @private */
+let activeName = null;
+
+/**
+ * A locale in Hebcal is used for translations/transliterations of
+ * holidays. `@hebcal/core` supports four locales by default
+ * * `en` - default, Sephardic transliterations (e.g. "Shabbat")
+ * * `ashkenazi` - Ashkenazi transliterations (e.g. "Shabbos")
+ * * `he` - Hebrew (e.g. "שַׁבָּת")
+ * * `he-x-NoNikud` - Hebrew without nikud (e.g. "שבת")
+ */
+class Locale {
+  /**
+   * Returns translation only if `locale` offers a non-empty translation for `id`.
+   * Otherwise, returns `undefined`.
+   * @param {string} id Message ID to translate
+   * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
+   * @return {string}
+   */
+  static lookupTranslation(id, locale) {
+    const locale0 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
+    const loc = typeof locale == 'string' && locales.get(locale0) || activeLocale;
+    const array = loc[id];
+    if (array && array.length && array[0].length) {
+      return array[0];
+    }
+    return undefined;
+  }
+
+  /**
+   * By default, if no translation was found, returns `id`.
+   * @param {string} id Message ID to translate
+   * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
+   * @return {string}
+   */
+  static gettext(id, locale) {
+    const text = this.lookupTranslation(id, locale);
+    if (typeof text == 'undefined') {
+      return id;
+    }
+    return text;
+  }
+
+  /**
+   * Register locale translations.
+   * @param {string} locale Locale name (i.e.: `'he'`, `'fr'`)
+   * @param {LocaleData} data parsed data from a `.po` file.
+   */
+  static addLocale(locale, data) {
+    if (typeof locale !== 'string') {
+      throw new TypeError(`Invalid locale name: ${locale}`);
+    }
+    if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
+      throw new TypeError(`Locale '${locale}' invalid compact format`);
+    }
+    locales.set(locale.toLowerCase(), data.contexts['']);
+  }
+
+  /**
+   * Adds a translation to `locale`, replacing any previous translation.
+   * @param {string} locale Locale name (i.e: `'he'`, `'fr'`).
+   * @param {string} id Message ID to translate
+   * @param {string} translation Translation text
+   */
+  static addTranslation(locale, id, translation) {
+    if (typeof locale !== 'string') {
+      throw new TypeError(`Invalid locale name: ${locale}`);
+    }
+    const locale0 = locale.toLowerCase();
+    const loc = locales.get(locale0);
+    if (!loc) {
+      throw new TypeError(`Unknown locale: ${locale}`);
+    }
+    if (typeof id !== 'string' || id.length === 0) {
+      throw new TypeError(`Invalid id: ${id}`);
+    }
+    const isArray = Array.isArray(translation);
+    if (isArray) {
+      const t0 = translation[0];
+      if (typeof t0 !== 'string' || t0.length === 0) {
+        throw new TypeError(`Invalid translation array: ${translation}`);
+      }
+    } else if (typeof translation !== 'string') {
+      throw new TypeError(`Invalid translation: ${translation}`);
+    }
+    loc[id] = isArray ? translation : [translation];
   }
-  throw new RangeError(`Unable to parse month name: ${monthName}`);
-}
-
-const NISAN$3 = months.NISAN;
-const CHESHVAN = months.CHESHVAN;
-const KISLEV$1 = months.KISLEV;
-const TEVET$1 = months.TEVET;
-const SHVAT = months.SHVAT;
-const ADAR_I$1 = months.ADAR_I;
-const ADAR_II = months.ADAR_II;
-/**
- * Returns true if the object is a Javascript Date
- * @private
- * @param {Object} obj
- */
-function isSimpleHebrewDate(obj) {
-  return typeof obj === 'object' && obj !== null && typeof obj.yy === 'number' && typeof obj.mm === 'number' && typeof obj.dd === 'number';
-}
-/**
- * @private
- */
-function toSimpleHebrewDate(obj) {
-  if (isSimpleHebrewDate(obj)) {
-    return obj;
-  } else if (typeof obj === 'number') {
-    return abs2hebrew(obj);
-  } else if (exports.greg.isDate(obj)) {
-    const abs = exports.greg.greg2abs(obj);
-    return abs2hebrew(abs);
-  } else {
-    throw new TypeError(`Argument not a Date: ${obj}`);
+  /**
+   * Adds multiple translations to `locale`, replacing any previous translations.
+   * @param {string} locale Locale name (i.e: `'he'`, `'fr'`).
+   * @param {LocaleData} data parsed data from a `.po` file.
+   */
+  static addTranslations(locale, data) {
+    if (typeof locale !== 'string') {
+      throw new TypeError(`Invalid locale name: ${locale}`);
+    }
+    const locale0 = locale.toLowerCase();
+    const loc = locales.get(locale0);
+    if (!loc) {
+      throw new TypeError(`Unknown locale: ${locale}`);
+    }
+    if (typeof data.contexts !== 'object' || typeof data.contexts[''] !== 'object') {
+      throw new TypeError(`Locale '${locale}' invalid compact format`);
+    }
+    const ctx = data.contexts[''];
+    Object.assign(loc, ctx);
   }
-}
-function getYahrzeitHD(hyear, date) {
-  let hDeath = toSimpleHebrewDate(date);
-  if (hyear <= hDeath.yy) {
-    // Hebrew year ${hyear} occurs on or before original date in ${hDeath.yy}
-    return undefined;
+  /**
+   * Activates a locale. Throws an error if the locale has not been previously added.
+   * After setting the locale to be used, all strings marked for translations
+   * will be represented by the corresponding translation in the specified locale.
+   * @param {string} locale Locale name (i.e: `'he'`, `'fr'`)
+   * @return {LocaleData}
+   */
+  static useLocale(locale) {
+    const locale0 = locale.toLowerCase();
+    const obj = locales.get(locale0);
+    if (!obj) {
+      throw new RangeError(`Locale '${locale}' not found`);
+    }
+    activeName = alias[locale0] || locale0;
+    activeLocale = obj;
+    return activeLocale;
   }
-  if (hDeath.mm == CHESHVAN && hDeath.dd == 30 && !longCheshvan(hDeath.yy + 1)) {
-    // If it's Heshvan 30 it depends on the first anniversary;
-    // if that was not Heshvan 30, use the day before Kislev 1.
-    hDeath = abs2hebrew(hebrew2abs(hyear, KISLEV$1, 1) - 1);
-  } else if (hDeath.mm == KISLEV$1 && hDeath.dd == 30 && shortKislev(hDeath.yy + 1)) {
-    // If it's Kislev 30 it depends on the first anniversary;
-    // if that was not Kislev 30, use the day before Teveth 1.
-    hDeath = abs2hebrew(hebrew2abs(hyear, TEVET$1, 1) - 1);
-  } else if (hDeath.mm == ADAR_II) {
-    // If it's Adar II, use the same day in last month of year (Adar or Adar II).
-    hDeath.mm = monthsInYear(hyear);
-  } else if (hDeath.mm == ADAR_I$1 && hDeath.dd == 30 && !isLeapYear(hyear)) {
-    // If it's the 30th in Adar I and year is not a leap year
-    // (so Adar has only 29 days), use the last day in Shevat.
-    hDeath.dd = 30;
-    hDeath.mm = SHVAT;
+
+  /**
+   * Returns the name of the active locale (i.e. 'he', 'ashkenazi', 'fr')
+   * @return {string}
+   */
+  static getLocaleName() {
+    return activeName;
   }
-  // In all other cases, use the normal anniversary of the date of death.
-  // advance day to rosh chodesh if needed
-  if (hDeath.mm == CHESHVAN && hDeath.dd == 30 && !longCheshvan(hyear)) {
-    hDeath.mm = KISLEV$1;
-    hDeath.dd = 1;
-  } else if (hDeath.mm == KISLEV$1 && hDeath.dd == 30 && shortKislev(hyear)) {
-    hDeath.mm = TEVET$1;
-    hDeath.dd = 1;
+
+  /**
+   * Returns the names of registered locales
+   * @return {string[]}
+   */
+  static getLocaleNames() {
+    const keys = Array.from(locales.keys());
+    return keys.sort((a, b) => a.localeCompare(b));
   }
-  hDeath.yy = hyear;
-  return hDeath;
-}
-function getBirthdayHD(hyear, date) {
-  const orig = toSimpleHebrewDate(date);
-  const origYear = orig.yy;
-  if (hyear === origYear) {
-    return orig;
-  } else if (hyear < origYear) {
-    // Hebrew year ${hyear} occurs on or before original date in ${origYear}
-    return undefined;
+
+  /**
+   * @param {number} n
+   * @param {string} [locale] Optional locale name (i.e: `'he'`, `'fr'`). Defaults to active locale.
+   * @return {string}
+   */
+  static ordinal(n, locale) {
+    const locale1 = locale === null || locale === void 0 ? void 0 : locale.toLowerCase();
+    const locale0 = locale1 || activeName;
+    if (!locale0) {
+      return this.getEnOrdinal(n);
+    }
+    switch (locale0) {
+      case 'en':
+      case 's':
+      case 'a':
+      case 'ashkenazi':
+      case 'ashkenazi_litvish':
+      case 'ashkenazi_poylish':
+      case 'ashkenazi_standard':
+        return this.getEnOrdinal(n);
+      case 'es':
+        return n + 'º';
+      case 'h':
+      case 'he':
+      case 'he-x-nonikud':
+        return String(n);
+      default:
+        return n + '.';
+    }
   }
-  const isOrigLeap = isLeapYear(origYear);
-  let month = orig.mm;
-  let day = orig.dd;
-  if (month == ADAR_I$1 && !isOrigLeap || month == ADAR_II && isOrigLeap) {
-    month = monthsInYear(hyear);
-  } else if (month == CHESHVAN && day == 30 && !longCheshvan(hyear)) {
-    month = KISLEV$1;
-    day = 1;
-  } else if (month == KISLEV$1 && day == 30 && shortKislev(hyear)) {
-    month = TEVET$1;
-    day = 1;
-  } else if (month == ADAR_I$1 && day == 30 && isOrigLeap && !isLeapYear(hyear)) {
-    month = NISAN$3;
-    day = 1;
+
+  /**
+   * @private
+   * @param {number} n
+   * @return {string}
+   */
+  static getEnOrdinal(n) {
+    const s = ['th', 'st', 'nd', 'rd'];
+    const v = n % 100;
+    return n + (s[(v - 20) % 10] || s[v] || s[0]);
+  }
+
+  /**
+   * Removes nekudot from Hebrew string
+   * @param {string} str
+   * @return {string}
+   */
+  static hebrewStripNikkud(str) {
+    return str.replace(/[\u0590-\u05bd]/g, '').replace(/[\u05bf-\u05c7]/g, '');
   }
-  return {
-    yy: hyear,
-    mm: month,
-    dd: day
-  };
 }
+Locale.addLocale('en', noopLocale);
+Locale.addLocale('s', noopLocale);
+Locale.addLocale('', noopLocale);
+Locale.useLocale('en');
 
 /**
  * @private
@@ -1784,7 +1776,7 @@ class Event {
     this.desc = desc;
     this.mask = +mask;
     if (typeof attrs === 'object' && attrs !== null) {
-      Object.keys(attrs).forEach(k => this[k] = attrs[k]);
+      Object.assign(this, attrs);
     }
   }
   /**
@@ -6574,10 +6566,10 @@ class Location extends GeoLocation {
     return true;
   }
 }
-classicCities0.forEach(city => {
+for (const city of classicCities0) {
   const location = new Location(city[2], city[3], city[1] == 'IL', city[4], city[0], city[1], undefined, city[5]);
   Location.addLocation(location.getName(), location);
-});
+}
 
 const _formatters = new Map();
 
@@ -9490,40 +9482,7 @@ const MINOR_HOLIDAY$1 = flags.MINOR_HOLIDAY;
 const EREV$1 = flags.EREV;
 // const CHOL_HAMOED = flags.CHOL_HAMOED;
 
-/**
- * Avoid dependency on ES6 Map object
- * @private
- */
-class SimpleMap {
-  /**
-   * @param {string} key
-   * @return {boolean}
-   */
-  has(key) {
-    return typeof this[key] !== 'undefined';
-  }
-  /**
-   * @param {string} key
-   * @return {any}
-   */
-  get(key) {
-    return this[key];
-  }
-  /**
-   * @param {string} key
-   * @param {any} val
-   */
-  set(key, val) {
-    this[key] = val;
-  }
-  /**
-   * @return {string[]}
-   */
-  keys() {
-    return Object.keys(this);
-  }
-}
-const sedraCache = new SimpleMap();
+const sedraCache = new Map();
 
 /**
  * @private
@@ -9567,16 +9526,15 @@ function getHolidaysForYear_(year) {
   }
   const RH = new HDate(1, TISHREI$1, year);
   const pesach = new HDate(15, NISAN$1, year);
-  const h = new SimpleMap();
+  const map = new Map();
   // eslint-disable-next-line require-jsdoc
   function add() {
     for (var _len = arguments.length, events = new Array(_len), _key = 0; _key < _len; _key++) {
       events[_key] = arguments[_key];
     }
-    // for (const ev of events) {
-    events.forEach(ev => {
+    for (const ev of events) {
       const key = ev.date.toString();
-      const arr = h.get(key);
+      const arr = map.get(key);
       if (typeof arr === 'object') {
         if (arr[0].getFlags() & flags.EREV) {
           arr.unshift(ev);
@@ -9584,17 +9542,17 @@ function getHolidaysForYear_(year) {
           arr.push(ev);
         }
       } else {
-        h.set(key, [ev]);
+        map.set(key, [ev]);
       }
-    });
+    }
   }
-  staticHolidays.forEach(h => {
+  for (const h of staticHolidays) {
     const hd = new HDate(h.dd, h.mm, year);
     const ev = new HolidayEvent(hd, h.desc, h.flags);
     if (h.emoji) ev.emoji = h.emoji;
     if (h.chmDay) ev.cholHaMoedDay = h.chmDay;
     add(ev);
-  });
+  }
 
   // standard holidays that don't shift based on year
   add(new RoshHashanaEvent(RH, year, CHAG | LIGHT_CANDLES_TZEIS$1));
@@ -9646,7 +9604,7 @@ function getHolidaysForYear_(year) {
   if (yomHaZikaronDt) {
     add(new HolidayEvent(yomHaZikaronDt, 'Yom HaZikaron', MODERN_HOLIDAY$1, emojiIsraelFlag), new HolidayEvent(yomHaZikaronDt.next(), 'Yom HaAtzma\'ut', MODERN_HOLIDAY$1, emojiIsraelFlag));
   }
-  staticModernHolidays.forEach(h => {
+  for (const h of staticModernHolidays) {
     if (year >= h.firstYear) {
       let hd = new HDate(h.dd, h.mm, year);
       const dow = hd.getDay();
@@ -9664,7 +9622,7 @@ function getHolidaysForYear_(year) {
       }
       add(ev);
     }
-  });
+  }
   let tamuz17 = new HDate(17, TAMUZ, year);
   let tamuz17attrs;
   if (tamuz17.getDay() == SAT$1) {
@@ -9735,8 +9693,8 @@ function getHolidaysForYear_(year) {
       emoji: '☀️'
     }));
   }
-  yearCache.set(year, h);
-  return h;
+  yearCache.set(year, map);
+  return map;
 }
 
 /**
@@ -9803,7 +9761,7 @@ class DailyLearning {
   }
 }
 
-const version="5.0.0";
+const version="5.0.2";
 
 const headers$1={"plural-forms":"nplurals=2; plural=(n > 1);"};const contexts$1={"":{Shabbat:["Shabbos"],"Achrei Mot":["Achrei Mos"],Bechukotai:["Bechukosai"],"Beha'alotcha":["Beha'aloscha"],Bereshit:["Bereshis"],Chukat:["Chukas"],"Erev Shavuot":["Erev Shavuos"],"Erev Sukkot":["Erev Sukkos"],"Ki Tavo":["Ki Savo"],"Ki Teitzei":["Ki Seitzei"],"Ki Tisa":["Ki Sisa"],Matot:["Matos"],"Purim Katan":["Purim Koton"],"Shabbat Chazon":["Shabbos Chazon"],"Shabbat HaChodesh":["Shabbos HaChodesh"],"Shabbat HaGadol":["Shabbos HaGadol"],"Shabbat Nachamu":["Shabbos Nachamu"],"Shabbat Parah":["Shabbos Parah"],"Shabbat Shekalim":["Shabbos Shekalim"],"Shabbat Shuva":["Shabbos Shuvah"],"Shabbat Zachor":["Shabbos Zachor"],Shavuot:["Shavuos"],"Shavuot I":["Shavuos I"],"Shavuot II":["Shavuos II"],Shemot:["Shemos"],"Shmini Atzeret":["Shmini Atzeres"],"Simchat Torah":["Simchas Torah"],Sukkot:["Sukkos"],"Sukkot I":["Sukkos I"],"Sukkot II":["Sukkos II"],"Sukkot II (CH''M)":["Sukkos II (CH''M)"],"Sukkot III (CH''M)":["Sukkos III (CH''M)"],"Sukkot IV (CH''M)":["Sukkos IV (CH''M)"],"Sukkot V (CH''M)":["Sukkos V (CH''M)"],"Sukkot VI (CH''M)":["Sukkos VI (CH''M)"],"Sukkot VII (Hoshana Raba)":["Sukkos VII (Hoshana Raba)"],"Ta'anit Bechorot":["Ta'anis Bechoros"],"Ta'anit Esther":["Ta'anis Esther"],Toldot:["Toldos"],Vaetchanan:["Vaeschanan"],Yitro:["Yisro"],"Vezot Haberakhah":["Vezos Haberakhah"],Parashat:["Parshas"],"Leil Selichot":["Leil Selichos"],"Shabbat Mevarchim Chodesh":["Shabbos Mevorchim Chodesh"],"Shabbat Shirah":["Shabbos Shirah"],Tevet:["Teves"],"Asara B'Tevet":["Asara B'Teves"],"Alot HaShachar":["Alos HaShachar"],"Kriat Shema, sof zeman":["Krias Shema, sof zman"],"Tefilah, sof zeman":["Tefilah, sof zman"],"Kriat Shema, sof zeman (MGA)":["Krias Shema, sof zman (MGA)"],"Tefilah, sof zeman (MGA)":["Tefilah, sof zman (MGA)"],"Chatzot HaLailah":["Chatzos HaLailah"],"Chatzot hayom":["Chatzos"],"Tzeit HaKochavim":["Tzeis HaKochavim"],"Birkat Hachamah":["Birkas Hachamah"],"Shushan Purim Katan":["Shushan Purim Koton"]}};var poAshkenazi = {headers:headers$1,contexts:contexts$1};
 
@@ -9816,9 +9774,9 @@ Locale.addLocale('he', poHe);
 Locale.addLocale('h', poHe);
 const heStrs = poHe.contexts[''];
 const heNoNikud = {};
-Object.keys(heStrs).forEach(key => {
-  heNoNikud[key] = [Locale.hebrewStripNikkud(heStrs[key][0])];
-});
+for (const [key, val] of Object.entries(heStrs)) {
+  heNoNikud[key] = [Locale.hebrewStripNikkud(val[0])];
+}
 const poHeNoNikud = {
   headers: poHe.headers,
   contexts: {
@@ -10611,24 +10569,12 @@ const RECOGNIZED_OPTIONS = {
  * @param {CalOptions} options
  */
 function warnUnrecognizedOptions(options) {
-  Object.keys(options).forEach(k => {
+  for (const k of Object.keys(options)) {
     if (typeof RECOGNIZED_OPTIONS[k] === 'undefined' && !unrecognizedAlreadyWarned.has(k)) {
       console.warn(`Ignoring unrecognized HebrewCalendar option: ${k}`);
       unrecognizedAlreadyWarned.add(k);
     }
-  });
-}
-
-/**
- * A bit like Object.assign(), but just a shallow copy
- * @private
- * @param {any} target
- * @param {any} source
- * @return {any}
- */
-function shallowCopy(target, source) {
-  Object.keys(source).forEach(k => target[k] = source[k]);
-  return target;
+  }
 }
 const israelCityOffset = {
   'Jerusalem': 40,
@@ -10989,6 +10935,7 @@ function observedInDiaspora(ev) {
   return ev.observedInDiaspora();
 }
 const yearArrayCache = new Map();
+const holidaysOnDate = new Map();
 
 /**
  * HebrewCalendar is the main interface to the `@hebcal/core` library.
@@ -11107,7 +11054,7 @@ class HebrewCalendar {
    */
   static calendar() {
     let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
-    options = shallowCopy({}, options); // so we can modify freely
+    options = Object.assign({}, options); // so we can modify freely
     checkCandleOptions(options);
     const location = options.location = options.location || defaultLocation;
     const il = options.il = options.il || location.il || false;
@@ -11156,9 +11103,9 @@ class HebrewCalendar {
       const dow = hd.getDay();
       let candlesEv;
       const ev = holidaysYear.get(hd.toString()) || [];
-      ev.forEach(e => {
+      for (const e of ev) {
         candlesEv = appendHolidayAndRelated(evts, e, options, candlesEv, dow);
-      });
+      }
       if (options.sedrot && dow === SAT) {
         const parsha0 = sedra.lookup(abs);
         if (!parsha0.chag) {
@@ -11167,8 +11114,7 @@ class HebrewCalendar {
       }
       const dailyLearning = options.dailyLearning;
       if (typeof dailyLearning === 'object') {
-        Object.keys(dailyLearning).forEach(key => {
-          const val = dailyLearning[key];
+        for (const [key, val] of Object.entries(dailyLearning)) {
           if (val) {
             const name = key === 'yerushalmi' ? val === 2 ? 'yerushalmi-schottenstein' : 'yerushalmi-vilna' : key;
             const learningEv = DailyLearning.lookup(name, hd);
@@ -11176,7 +11122,7 @@ class HebrewCalendar {
               evts.push(learningEv);
             }
           }
-        });
+        }
       }
       if (options.omer && abs >= beginOmer && abs <= endOmer) {
         const omer = abs - beginOmer + 1;
@@ -11338,20 +11284,29 @@ class HebrewCalendar {
   }
 
   /**
-   * Returns an array of Events on this date (or undefined if no events)
+   * Returns an array of Events on this date (or `undefined` if no events)
    * @param {HDate|Date|number} date Hebrew Date, Gregorian date, or absolute R.D. day number
    * @param {boolean} [il] use the Israeli schedule for holidays
    * @return {Event[]}
    */
   static getHolidaysOnDate(date, il) {
     const hd = HDate.isHDate(date) ? date : new HDate(date);
+    const hdStr = hd.toString();
+    const cacheKey = hdStr + '/' + (typeof il === 'undefined' ? 2 : il ? 1 : 0);
+    if (holidaysOnDate.has(cacheKey)) {
+      return holidaysOnDate.get(cacheKey);
+    }
     const yearMap = getHolidaysForYear_(hd.getFullYear());
-    const events = yearMap.get(hd.toString());
+    const events = yearMap.get(hdStr);
+    // if il isn't a boolean return both diaspora + IL for day
     if (typeof il === 'undefined' || typeof events === 'undefined') {
+      holidaysOnDate.set(cacheKey, events);
       return events;
     }
     const myFilter = il ? observedInIsrael : observedInDiaspora;
-    return events.filter(myFilter);
+    const filtered = events.filter(myFilter);
+    holidaysOnDate.set(cacheKey, filtered);
+    return filtered;
   }
 
   /**