hdate1
Displays hebrew date information for a given gregorian/julian date
Usage
hdate [options]
[coordinates
[timezone]]
[[[dd]
mm]
yyyy]
hdate [options]
[coordinates
[timezone]]
[julian_day]
Overview
hdate translates the specified date to the Hebrew calendar and optionally displays further information about that Hebrew date, including holidays and astronomical-related times (see section LOCATION, below). If no arguments are given, it displays information for the current date. If a single numeric argument is given, it will be interpreted as a year, and hdate will output the requested information for all days of that year. If two numeric arguments are given, it will be interpreted as mm yyyy, and hdate will output the requested information for all days of that month.
INPUTTING A HEBREW DATE: If the year provided is greater than 3000, hdate will interpret the given date as a Hebrew date, and will display information for the corresponding Gregorian date. Hebrew months are expected to be passed as numbers 1-12 for Tishrei - Elul; Adar I and Adar II are expected to be passed as months 13 and 14.
INPUTTING A JULIAN DAY: If a single numeric argument is provided, and it is greater than 348021, hdate will interpret it as the "Julian day number" and will display information for the corresponding Hebrew date.
Options
-
-b --bidi -
output Hebrew information in Hebrew, but in reverse
--visual sequence.
-
-c -
print Shabbat start/end times. Shabbat starts 20 min before sunset, and ends when three stars are out.
-
-d --diaspora -
use diaspora reading and holidays.
-
-h --holidays -
print holidays.
-
-H -
Print only if it is a holiday.
-
-i --ical -
use iCal formatted output.
-
-j --julian -
print Julian day number.
-
-o --omer -
print Sefirat Ha Omer
-
-q --quiet-alerts -
quiet. suppress warning messages
-
-r --parasha -
print weekly reading for Shabbat.
-
-R -
print only if the weekly reading is read on that Shabbat
-
-s --sun -
print sunrise/sunset times.
-
-S --short-format -
print using short format.
-
-t -
print day times: first light, talit, sunrise, mid day, sunset, first stars, three stars
-
-T --table -
print tabular output. All data for each requested day will be output on a single comma-delimited line. Most suitable for piping, or export to spreadsheets0n.TP -l --latitude [NS]yy[.yyy] decimal degrees, or [NS]yy[:mm[:ss]] degrees, minutes, seconds. Negative values are South
-
-L --longitude -
[EW]xx[.xxx] decimal degrees, or [EW]xx[:mm[:ss]] degrees, minutes, seconds. Negative values are West
-
-z --timezone -
+/-UTC. Notation may be in decimal hours ( hh[.hh] ) or hours, minutes ( hh[:mm] )
-
--hebrew -
forces Hebrew to print in Hebrew characters
-
--yom -
force Hebrew prefix to Hebrew day of week
-
--leshabbat -
insert parasha between day of week and day
-
--leseder -
insert parasha between day of week and day
-
--not-sunset-aware -
don't display next day if after sunset
-
Notes
Locations
If you want hdate to display accurate time-of-day information, hdate requires location and time zone information in order to make astronomical calculations for a given date. If you don't provide ANY such information, hdate uses your computer's local time zone information as an indicator, and either picks a city in that time zone, or defaults to the equator at the center of that time zone. If hdate can't even retrieve time zone information from your computer, it defaults to Tel-Aviv. For other locations, use the -l -L option pair. For other timezones, use the -z option. Co-ordinates and standard time zones for some common locations are listed below.
The current defaults include:
Timezone Default city Lattitude Longitude
-5 New York City 40 -74
0 London 51 0
1 Paris 48 2
2 Tel-Aviv 32 34
3 Moscow 55 37
Useful locations and time zones
Jerusalem 31, 35, 2 Buenos Aires 34, -58, -3
Tel Aviv 32, 34, 2 Hong Kong 22, 114, 8
Haifa 32, 34, 2 Los Angeles 34, -118, -8
Beer Sheva 31, 34, 2 Sao Paolo 23, -46, -3
Ashdod 31, 34, 2 Toronto 43, -79 -5
Tiberias 32, 35, 2
Eilat 29, 34, 2
Files
Config file
This folder and file will be automatically created, and includes its own documentation, in-line:
${XDG_CONFIG_HOME}/hcal/hcalrc
If ${XDG_CONFIG_HOME} is undefined:
~/.config/hcal/hcalrc
Examples
1. Create an iCal calendar of the holidays of year 2025.
hdate -Hi 2025
2. Print out the weekly readings and sunset/sunrise times for Eilat, on April 2031.
hdate -sR 4 2031 -l29 -L34 -z2
Releases
10 releases since Debian 4.0 (Etch); the text changed 4 times.
--bidi since Debian 7 (Wheezy);
--diaspora since Debian 7 (Wheezy);
--hebrew since Debian 7 (Wheezy);
--holidays since Debian 7 (Wheezy);
--ical since Debian 7 (Wheezy);
--julian since Debian 7 (Wheezy);
--leseder since Debian 7 (Wheezy);
--leshabbat since Debian 7 (Wheezy);
--longitude since Debian 7 (Wheezy);
--not-sunset-aware since Debian 7 (Wheezy);
--omer since Debian 7 (Wheezy);
--parasha since Debian 7 (Wheezy);
--quiet-alerts since Debian 7 (Wheezy);
--short-format since Debian 7 (Wheezy);
--sun since Debian 7 (Wheezy);
--table since Debian 7 (Wheezy);
--timezone since Debian 7 (Wheezy);
--yom since Debian 7 (Wheezy);
-H since Debian 7 (Wheezy);
-L since Debian 7 (Wheezy);
-R since Debian 7 (Wheezy);
-S since Debian 7 (Wheezy);
-T since Debian 7 (Wheezy);
-b since Debian 7 (Wheezy);
-c since Debian 7 (Wheezy);
-d since Debian 7 (Wheezy);
-h since Debian 7 (Wheezy);
-i since Debian 7 (Wheezy);
-j since Debian 7 (Wheezy);
-o since Debian 7 (Wheezy);
-q since Debian 7 (Wheezy);
-r since Debian 7 (Wheezy);
-s since Debian 7 (Wheezy);
-t since Debian 7 (Wheezy);
-z since Debian 7 (Wheezy).