import { HDate } from '@hebcal/hdate'; import { Event } from './event'; import './locale'; /** * Language for counting the Omer can be English or Hebrew. * Lang for the Sefira can be English, Hebrew, or Hebrew in Sephardic transliteration. */ export type OmerLang = 'en' | 'he' | 'translit'; /** * Represents one of the 49 days of counting the Omer between Pesach and * Shavuot (16 Nisan through 5 Sivan). * * Each day has an associated Sefirah pairing (e.g. *Chesed shebiGevurah*), * a word from Psalm 67 (Lamnatzeach), a letter from verse 5 of Psalm 67, * and a word/acrostic from the Ana BeKoach prayer — all accessible via * the methods on this class. * * @example * import {OmerEvent, HDate, months} from '@hebcal/core'; * const ev = new OmerEvent(new HDate(16, months.NISAN, 5784), 1); * ev.render('en'); // '1st day of the Omer' * ev.render('he'); // 'א׳ בָּעוֹמֶר' * ev.sefira('translit'); // 'Chesed shebChesed' * ev.getTodayIs('en'); // 'Today is 1 day of the Omer' */ export declare class OmerEvent extends Event { private readonly weekNumber; private readonly daysWithinWeeks; readonly omer: number; /** * Constructs an Omer event for a given day (1–49). * * Throws `RangeError` if `omerDay` is outside 1–49. * @param date Hebrew date this Omer day is counted on (the evening of) * @param omerDay day of the Omer, 1 through 49 */ constructor(date: HDate, omerDay: number); /** * Returns the Sefirah pairing associated with this Omer day — * one of the seven lower Sefirot within another, calculated as * `day-within-week` of `week-within-cycle`. For example, on day 8 * (week 2, day 1): * * חֶֽסֶד שֶׁבִּגְבוּרָה * * Chesed shebiGevurah * * Lovingkindness within Might * @example * import {OmerEvent, HDate, months} from '@hebcal/core'; * const day8 = new OmerEvent(new HDate(23, months.NISAN, 5784), 8); * day8.sefira('en'); // 'Lovingkindness within Might' * day8.sefira('he'); // 'חֶֽסֶד שֶׁבִּגְבוּרָה' * day8.sefira('translit'); // 'Chesed shebiGevurah' * @param lang `en` (English), `he` (Hebrew with nikud), or `translit` (Hebrew in Sephardic transliteration) * @returns a string such as `Lovingkindness within Might` or `חֶֽסֶד שֶׁבִּגְבוּרָה` */ sefira(lang?: OmerLang): string; /** * @param [locale] Optional locale name (defaults to empty locale) */ render(locale?: string): string; /** * Returns translation of "Omer day 22" without ordinal numbers. * @param [locale] Optional locale name (defaults to empty locale) */ renderBrief(locale?: string): string; /** * Returns an emoji number symbol with a circle, for example `㊲` * from the “Enclosed CJK Letters and Months” block of the Unicode standard * @returns a single Unicode character from `①` through `㊾` */ getEmoji(): string; getWeeks(): number; getDaysWithinWeeks(): number; /** * Returns a sentence with that evening's omer count * @returns a string such as `Today is 10 days, which is 1 week and 3 days of the Omer` * or `הַיוֹם עֲשָׂרָה יָמִים, שְׁהֵם שָׁבוּעַ אֶחָד וְשְׁלוֹשָׁה יָמִים לָעוֹמֶר` */ getTodayIs(locale: string): string; url(): string | undefined; /** * Returns the word from Psalm 67 (לַמְנַצֵּחַ, "Lamnatzeach") corresponding * to this Omer day. Psalm 67 contains 49 words (excluding its opening verse), * one for each day of the Omer. The words are taken from verses 2–8, split on * spaces and maqef (־). * @returns a Hebrew word from Psalm 67 * @example * const ev = new OmerEvent(new HDate(16, 'Nisan', 5785), 1); * ev.getLamnatzeachWord(); // 'אֱלֹהִים' (day 1, first word of verse 2) * @example * const ev = new OmerEvent(new HDate(3, 'Sivan', 5785), 49); * ev.getLamnatzeachWord(); // 'אָרֶץ' (day 49, last word of verse 8) */ getLamnatzeachWord(): string; /** * Returns the letter from verse 5 of Psalm 67 corresponding to this Omer day. * Verse 5 (יִשְׂמְחוּ וִירַנְּנוּ לְאֻמִּים…) contains exactly 49 letters, * one for each day of the Omer, and is used as a Kabbalistic meditation during * the counting. * @returns a single Hebrew letter from verse 5 of Psalm 67 * @example * const ev = new OmerEvent(new HDate(16, 'Nisan', 5785), 1); * ev.getLamnatzeachLetter(); // 'י' (day 1, first letter of verse 5) * @example * const ev = new OmerEvent(new HDate(3, 'Sivan', 5785), 49); * ev.getLamnatzeachLetter(); // 'ה' (day 49, last letter of verse 5) */ getLamnatzeachLetter(): string; /** * Returns the word from the Ana BeKoach prayer (אָנָּא בְּכֹחַ) corresponding * to this Omer day. Ana BeKoach is a 42-word Kabbalistic prayer whose initial * letters spell out the 42-letter name of God. The prayer has 7 verses of * 6 words each; the 7th entry of each group is the abbreviation of the acrostic * letters for that verse (e.g. `אב״ג ית״ץ` for verse 1). Together the 49 * entries (7 verses × 7 entries) align with the 49 days of the Omer, connecting * each day to one of the lower seven Sefirot within a Sefirah. * @returns a Hebrew word or verse-abbreviation string from Ana BeKoach * @example * const ev = new OmerEvent(new HDate(16, 'Nisan', 5785), 1); * ev.getAnaBekoachWord(); // 'אָנָּא' (day 1, first word of verse 1) * @example * const ev = new OmerEvent(new HDate(22, 'Nisan', 5785), 7); * ev.getAnaBekoachWord(); // 'אב״ג ית״ץ' (day 7, acrostic abbreviation for verse 1) * @example * const ev = new OmerEvent(new HDate(3, 'Sivan', 5785), 49); * ev.getAnaBekoachWord(); // 'שק״ו צי״ת' (day 49, acrostic abbreviation for verse 7) */ getAnaBekoachWord(): string; }