JewCal

Convert Gregorian to Jewish dates with holidays and zmanim (Diaspora/Israel).

Get info about:

• The Jewish date
• Shabbos and Yom Tov events
• The action (Candles or Havdalah)
• The zmanim
  • Sunrise
  • Sunset
  • Plag Hamincha
  • Hadlokas Haneiros (adjust the minutes before sunset)
  • Tzeis (adjust to stars or minutes after sunset)

Determine whether it is:

• Erev Shabbos or Erev Yom Tov
• Shabbos
• Yom Tov
• Issur Melacha

If latitude and longitude are specified, nightfall is taken into account to calculate the Jewish date.

Quickstart

Install with pip:

pip install jewcal

Run in the console:

jewcal

The output:

Today is 23 Iyar 5784

today.has_events()=True
today.is_erev()=True
today.is_erev_shabbos()=True
today.is_shabbos()=False
today.is_erev_yomtov()=False
today.is_yomtov()=False
today.is_issur_melacha()=False

JewCal(
  jewish_date=JewishDate(
    year=5784, month=2, day=23,
    gregorian_date=datetime.date(2024, 5, 31)
  ),
  events=Events(
    shabbos='Erev Shabbos',
    yomtov=None,
    action='Candles'
  ),
  diaspora=True,
  zmanim=None
)


Zmanim for Jerushalayim:
{
  'hadlokas_haneiros': '2024-05-31T15:59:58.418285+00:00',
  'plag_hamincha': '2024-05-31T15:11:40.067150+00:00',
  'sunrise': '2024-05-31T02:32:14.247357+00:00',
  'sunset': '2024-05-31T16:39:58.418285+00:00',
  'tzeis_hakochavim': '2024-05-31T17:21:58.418285+00:00',
  'tzeis_minutes': '2024-05-31T17:51:58.418285+00:00'
}

Location(
  latitude=31.76904, longitude=35.21633,
  use_tzeis_hakochavim=True,
  hadlokas_haneiros_minutes=40,
  tzeis_minutes=72
)

Resources

• JewCal @ PyPI
• JewCal @ Read the Docs