hebrew-dates

hebrew-dates — Hebrew/Jewish Calendar, Holidays & Date Conversion for TypeScript

Convert Gregorian to Hebrew dates, look up Jewish holidays, and format in Hebrew — all typed, tree-shakeable, zero dependencies.

import { toHebrew, formatHebrew, getHoliday } from "hebrew-dates";

const hDate = toHebrew(new Date(2024, 9, 3));
formatHebrew(hDate); // "א׳ תשרי תשפ״ה"
getHoliday(hDate); // { name: "Rosh Hashana", nameHe: "ראש השנה" }

Modern Hebrew/Jewish calendar library for TypeScript. Zero dependencies.

Install

npm install hebrew-dates

Usage

import {
  toHebrew,
  toGregorian,
  formatHebrew,
  formatHebrewEn,
  getHoliday,
  getHolidaysInMonth,
} from "hebrew-dates";

const hDate = toHebrew(new Date(2024, 9, 3));
// { year: 5785, month: 7, day: 1 }

formatHebrew(hDate);
// "א׳ תשרי תשפ״ה"

formatHebrewEn(hDate);
// "1 Tishrei 5785"

const holiday = getHoliday(hDate);
// { name: "Rosh Hashana", nameHe: "ראש השנה", type: "major" }

const gregDate = toGregorian({ year: 5785, month: 7, day: 10 });
// Date object for Yom Kippur 5785

const tishrei = getHolidaysInMonth(5785, 7);
// All holidays in Tishrei 5785

API

Date Conversion

Function	Description
toHebrew(date: Date)	Convert Gregorian to Hebrew date
toGregorian(hDate)	Convert Hebrew to Gregorian date

Formatting

Function	Description
formatHebrew(hDate)	Format as Hebrew string (e.g. "א׳ תשרי תשפ״ה")
formatHebrewEn(hDate)	Format as English string (e.g. "1 Tishrei 5785")
getMonthName(month, leap)	Hebrew month name
getMonthNameEn(month, leap)	English month name

Holidays

Function	Description
getHoliday(hDate)	Get holiday for a date (or null)
getHolidaysInMonth(year, month)	All holidays in a month

Holiday types: major, minor, modern, fast

Calendar Utilities

Function	Description
isLeapYear(year)	Check if Hebrew year is a leap year
monthsInYear(year)	Number of months (12 or 13)
daysInMonth(year, month)	Days in a Hebrew month
hebrewYearDays(year)	Total days in a Hebrew year

Supported Holidays

Major: Rosh Hashana, Yom Kippur, Sukkot, Shmini Atzeret, Simchat Torah, Pesach, Shavuot

Minor: Chanukah, Purim, Shushan Purim, Tu BiShvat, Lag BaOmer, Tu B'Av, Chol HaMoed

Fast Days: Tzom Gedaliah, Asara B'Tevet, Ta'anit Esther, Shiva Asar B'Tammuz, Tisha B'Av

Modern: Yom HaShoah, Yom HaZikaron, Yom HaAtzmaut, Yom Yerushalayim

Hebrew Month Numbers

#	Month	Hebrew
1	Nisan	ניסן
2	Iyyar	אייר
3	Sivan	סיוון
4	Tammuz	תמוז
5	Av	אב
6	Elul	אלול
7	Tishrei	תשרי
8	Cheshvan	חשוון
9	Kislev	כסלו
10	Tevet	טבת
11	Shevat	שבט
12	Adar (Adar I in leap years)	אדר
13	Adar II (leap years only)	אדר ב׳

Author

Ofer Shapira

License

MIT © Ofer Shapira