Command-line interface

Installing hebrewcal provides a hebrewcal command (and the equivalent python -m hebrewcal). It uses only the standard library and covers the everyday tasks. Run hebrewcal --help or hebrewcal <command> --help for the full options.

convert

Convert a Gregorian date (ISO 8601, DIN 5008 or slash form) to Hebrew (default) or Julian.

$ hebrewcal convert 2024-10-03
1 Tishri 5785 (Yom Chamishi)
$ hebrewcal convert 26.06.2026
11 Tammuz 5786 (Yom Shishi)
$ hebrewcal convert 2026-06-26 --to julian
2026-06-13 (Julian)

holidays

List the observances of a Hebrew (Anno Mundi) year; --israel selects the Israeli schedule.

$ hebrewcal holidays 5785
2024-10-03  Rosh Hashanah  [major_festival]
2024-10-04  Rosh Hashanah  [major_festival]
...

parasha

The weekly Torah portion for a Shabbat (--israel for the Israeli schedule).

$ hebrewcal parasha 2024-10-26
Bereshit

shabbat and zmanim

These take a date and a location (--lat, --lon in degrees, --tz an IANA zone).

$ hebrewcal shabbat 2026-06-26 --lat 40.71 --lon -74.01 --tz America/New_York
Candle lighting: 20:13
Havdalah: 21:21

$ hebrewcal zmanim 2026-06-26 --lat 31.77 --lon 35.21 --tz Asia/Jerusalem
Sunrise: 05:35
Sof zman Shma (GRA): 09:08
Chatzot: 12:42
Sunset: 19:48
Tzeit: 20:30