Skip to content

Shmulik-Kravitz/jewish-holidays

Repository files navigation

Jewish Holidays

An easy-to-use npm package for checking Jewish holidays and Shabbat.

npm version License Build Status Code Coverage

## Installation

To install the package, run one of the following commands:

npm i jewish-holidays

or with yarn

yarn add jewish-holidays

Usage

You can use the package in your JavaScript projects as shown below:

import { isYomTov, isShabbat } from 'jewish-holidays';

// Check if a date is Yom Tov
const date = new Date();
const isInChutzLaaretz = true; // Adjust as needed
console.log(isYomTov(date, isInChutzLaaretz)); // true or false

// Check if a date is Shabbat
console.log(isShabbat(date)); // true or false

Functions

isYomTov

isYomTov(date: Date | BasicJewishDate, isChutzLaaretz: boolean) => boolean

Determines if the given date is a Yom Tov (Jewish holiday).

  • date: A JavaScript Date object or a BasicJewishDate object.
  • isChutzLaaretz: A boolean indicating if the calculation should consider diaspora holidays.

isShabbat

isShabbat(date: Date | BasicJewishDate) => boolean

Determines if the given date is Shabbat.

  • date: A JavaScript Date object or a BasicJewishDate object.

isErevShabbat

isErevShabbat(date: Date | BasicJewishDate) => boolean

Determines if the given date is Erev Shabbat (Friday).

  • date: A JavaScript Date object or a BasicJewishDate object.

isErevYomTov

isErevYomTov(date: Date | BasicJewishDate) => boolean

Determines if the given date is Erev Yom Tov (the day before a Jewish holiday).

  • date: A JavaScript Date object or a BasicJewishDate object.

isCholHaMoed

isCholHaMoed(date: Date | BasicJewishDate, isChutzLaaretz?: boolean) => boolean

Determines if the given date is Chol HaMoed (the intermediate days of Passover or Sukkot).

  • date: A JavaScript Date object or a BasicJewishDate object.
  • isChutzLaaretz: (optional) A boolean indicating if the calculation should consider diaspora holidays.

isRoshChodesh

isRoshChodesh(date: Date | BasicJewishDate) => boolean

Determines if the given date is Rosh Chodesh (the beginning of a new Jewish month).

  • date: A JavaScript Date object or a BasicJewishDate object.

isChanukah

isChanukah(date: Date | BasicJewishDate) => boolean

Determines if the given date is during Chanukah.

  • date: A JavaScript Date object or a BasicJewishDate object.

isPurim

isPurim(date: Date | BasicJewishDate) => boolean

Determines if the given date is Purim.

  • date: A JavaScript Date object or a BasicJewishDate object.

isTzom

isTzom(date: Date | BasicJewishDate) => boolean

Determines if the given date is a Jewish fast day (Tzom).

  • date: A JavaScript Date object or a BasicJewishDate object.

License

MIT

About

A simple npm package to check Jewish holidays and Shabbat.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •