Hebcal
App · Calendars · 16 actions
Look up anything on the Jewish calendar. Get holidays for any year, candle lighting and Havdalah times for any city, the weekly Torah portion with its aliyot and haftarah, Daf Yomi and fifteen other daily learning cycles, the count of the Omer, the halachic times of the day, yahrzeit and Hebrew birthday dates, and conversion between Hebrew and ordinary dates either way. It can also answer whether a given moment falls in Shabbat or a festival, so a workflow can hold off until it ends. No account or API key is required.
Actions
| Action | What it does |
|---|---|
| Check whether work is forbidden | Check whether a moment falls inside Shabbat or a Yom Tov, when work is forbidden. |
| Convert a date to the Hebrew calendar | Convert one Gregorian date to its Hebrew date, and list any holiday or Torah portion falling on it. |
| Convert a Hebrew date to the ordinary calendar | Convert one Hebrew date to its Gregorian date, and list any holiday or Torah portion falling on it. |
| Get a Torah reading | Get one date's Torah reading aliyah by aliyah: the full kriyah as seven aliyot plus the maftir, the haftarah, the triennial cycle reading many Conservative congregations follow, and the Monday and Thursday weekday reading. |
| Get halachic times for a day | Get the zmanim of one day at a place: dawn, sunrise, the latest times for Shema and Shacharit under each opinion, midday, the Mincha times, Plag HaMincha, sunset and the several opinions on nightfall. |
| Get Shabbat times | Get one week's candle lighting, Torah portion and Havdalah for a place, pulled apart into fields a message can use directly. |
| List candle lighting times | List candle lighting and Havdalah times for a place over a date range. |
| List daily learning | List the page due each day on any of sixteen daily learning cycles, from Daf Yomi and Mishna Yomi to the two Yerushalmi cycles, the Rambam, Sefer Chofetz Chaim and Pirkei Avot. |
| List days of the Omer | List the count of the Omer, the forty-nine days between Pesach and Shavuot, with the wording of each night's count and the sefirah the day belongs to. |
| List halachic times for a date range | Get the zmanim of every day in a range at a place, one row per day. |
| List Hebrew dates for a date range | Convert every day in a date range to its Hebrew date, with the weekday and any holiday or Torah portion falling on it. |
| List Jewish holidays | List Jewish holidays over a date range or a whole Hebrew year. |
| List ordinary dates from a Hebrew date | Convert a run of days starting from a Hebrew date to ordinary calendar dates. |
| List Torah readings for a date range | List every Torah reading occasion in a date range, with the verses read for each. |
| List weekly Torah portions | List Parashat ha-Shavua week by week over a date range or a whole Hebrew year, with the verses read, the haftarah and the maftir for each. |
| List yahrzeit and anniversary dates | Work out the Hebrew anniversaries of a date for a run of years. |
Check whether work is forbidden
Check whether a moment falls inside Shabbat or a Yom Tov, when work is forbidden. This is the question a scheduler actually asks: not 'is it Saturday?' but 'may this run now?'. Shabbat and the festivals begin at sunset and end at nightfall, so the answer depends on the place as much as the moment. Leave the moment empty to ask about right now.
Inputs
- City search
city_searchtext - Type a city name or a US ZIP code here, then choose the exact place from the City list below.
- City
locationtext - The place these times are for. Fill in the city search above and this list fills with the matching cities and ZIP codes. Leave both empty only if you are giving a latitude and longitude instead.
- Latitude
latitudenumber - Latitude in degrees, for a place that is not a city on the list. Needs a longitude and a time zone as well.From -90.0 to 90.0.
- Longitude
longitudenumber - Longitude in degrees, for a place that is not a city on the list. Needs a latitude and a time zone as well.From -180.0 to 180.0.
- Time zone
time_zonetext - The time zone of the latitude and longitude above. Not needed when a city is chosen, since a city already carries its own.
- Elevation in metres
elevationnumber - Height above sea level, which moves sunrise and sunset in hill country. Leave empty to ignore elevation, as most communities do.From 1 to 9000.
- Moment to check
momentdate and time - The date and time to ask about. Leave empty to ask about right now.
Outputs
is_work_forbiddentrue/falselocal_timetextlocationtextmomenttexttime_zonetext
Example output
{
"is_work_forbidden": true,
"local_time": "2026-06-20T16:08:10-04:00",
"location": "New York City, New York, USA",
"moment": "2026-06-20T20:08:10Z",
"time_zone": "America/New_York"
}Convert a date to the Hebrew calendar
Convert one Gregorian date to its Hebrew date, and list any holiday or Torah portion falling on it. A Hebrew day begins at sunset, so turn on 'after sunset' for something that happened after dark: that belongs to the next Hebrew date.
Inputs
- Date
gregorian_datedateRequired - The ordinary calendar date to convert.
- After sunset
after_sunsettrue/false - Turn this on if the event happened after sunset, which puts it on the next Hebrew date.Default:
false. - Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
after_sunsettrue/falseday_of_weektexteventslistgregorian_datetexthebrewtexthebrew_datetexthebrew_daynumberhebrew_monthtexthebrew_yearnumber
Example output
{
"after_sunset": false,
"day_of_week": "Wednesday",
"events": [
"Parashat Korach"
],
"gregorian_date": "2026-06-17",
"hebrew": "\u05d1\u05f3 \u05d1\u05b0\u05bc\u05ea\u05b7\u05de\u05bc\u05d5\u05bc\u05d6 \u05ea\u05e9\u05e4\u05f4\u05d5",
"hebrew_date": "2 Tamuz 5786",
"hebrew_day": 2,
"hebrew_month": "Tamuz",
"hebrew_year": 5786
}Convert a Hebrew date to the ordinary calendar
Convert one Hebrew date to its Gregorian date, and list any holiday or Torah portion falling on it.
Inputs
- Hebrew year
hebrew_yearnumberRequired - The Hebrew year, for example 5786.From 1 to 9999.
- Hebrew month
hebrew_monthtextRequired - The Hebrew month. In a leap year Adar means Adar II; in an ordinary year all three Adars are the same month.One of:
Nisan(Nisan: March or April),Iyyar(Iyyar: April or May),Sivan(Sivan: May or June),Tamuz(Tamuz: June or July),Av(Av: July or August),Elul(Elul: August or September),Tishrei(Tishrei: September or October),Cheshvan(Cheshvan: October or November),Kislev(Kislev: November or December),Tevet(Tevet: December or January), and 4 more. - Hebrew day of the month
hebrew_daynumberRequired - The day of the Hebrew month, 1 to 30.From 1 to 30.
- Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
day_of_weektexteventslistgregorian_datetexthebrewtexthebrew_datetexthebrew_daynumberhebrew_monthtexthebrew_yearnumber
Example output
{
"day_of_week": "Monday",
"events": [
"Chanukah day 1",
"Parashat Miketz"
],
"gregorian_date": "2025-12-15",
"hebrew": "\u05db\u05f4\u05d4 \u05d1\u05b0\u05bc\u05db\u05b4\u05e1\u05b0\u05dc\u05b5\u05d5 \u05ea\u05e9\u05e4\u05f4\u05d5",
"hebrew_date": "25 Kislev 5786",
"hebrew_day": 25,
"hebrew_month": "Kislev",
"hebrew_year": 5786
}Get a Torah reading
Get one date's Torah reading aliyah by aliyah: the full kriyah as seven aliyot plus the maftir, the haftarah, the triennial cycle reading many Conservative congregations follow, and the Monday and Thursday weekday reading. A date with no reading of its own answers with empty fields rather than an error.
Inputs
- Date
reading_datedateRequired - The day whose reading you want.
- Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Include the triennial cycle
include_triennialtrue/false - Also return the triennial reading, the third of the portion many Conservative congregations read. Available from Hebrew year 5745 on.Default:
true.
Outputs
aliyotlistdatetexthaftarahtexthaftarah_booktexthebrewtexthebrew_datetextnametextparsha_numbernumbersummarytexttriennial_aliyotlisttriennial_haftarahtexttriennial_yearnumbertypetextweekday_aliyotlist
Example output
{
"aliyot": [
{
"aliyah": "1",
"begin": "16:1",
"book": "Numbers",
"end": "16:13",
"reason": "",
"verses": 13
},
{
"aliyah": "Maftir",
"begin": "18:30",
"book": "Numbers",
"end": "18:32",
"reason": "",
"verses": 3
}
],
"date": "2026-06-20",
"haftarah": "I Samuel 11:14-12:22",
"haftarah_book": "I Samuel",
"hebrew": "\u05e7\u05b9\u05e8\u05b7\u05d7",
"hebrew_date": "5 Tamuz 5786",
"name": "Korach",
"parsha_number": 38,
"summary": "Numbers 16:1-18:32",
"triennial_aliyot": [
{
"aliyah": "1",
"begin": "16:1",
"book": "Numbers",
"end": "16:3",
"reason": "",
"verses": 3
}
],
"triennial_haftarah": "I Samuel 12:1-13",
"triennial_year": 1,
"type": "shabbat",
"weekday_aliyot": []
}Get halachic times for a day
Get the zmanim of one day at a place: dawn, sunrise, the latest times for Shema and Shacharit under each opinion, midday, the Mincha times, Plag HaMincha, sunset and the several opinions on nightfall. Every time comes back as a full timestamp in the city's own time zone.
Inputs
- City search
city_searchtext - Type a city name or a US ZIP code here, then choose the exact place from the City list below.
- City
locationtext - The place these times are for. Fill in the city search above and this list fills with the matching cities and ZIP codes. Leave both empty only if you are giving a latitude and longitude instead.
- Latitude
latitudenumber - Latitude in degrees, for a place that is not a city on the list. Needs a longitude and a time zone as well.From -90.0 to 90.0.
- Longitude
longitudenumber - Longitude in degrees, for a place that is not a city on the list. Needs a latitude and a time zone as well.From -180.0 to 180.0.
- Time zone
time_zonetext - The time zone of the latitude and longitude above. Not needed when a city is chosen, since a city already carries its own.
- Elevation in metres
elevationnumber - Height above sea level, which moves sunrise and sunset in hill country. Leave empty to ignore elevation, as most communities do.From 1 to 9000.
- Date
zmanim_datedate - The day to work the times out for. Leave empty for today.
- Include seconds
include_secondstrue/false - Return times to the second instead of rounding to the nearest minute.Default:
false.
Outputs
datetextlocationtexttime_zonetexttimesobject
Example output
{
"date": "2026-06-17",
"location": "New York City, New York, USA",
"time_zone": "America/New_York",
"times": {
"alosBaalHatanya": "2026-06-17T03:28:00-04:00",
"alotHaShachar": "2026-06-17T03:35:00-04:00",
"beinHaShmashos": "2026-06-17T20:57:00-04:00",
"chatzot": "2026-06-17T12:57:00-04:00",
"chatzotNight": "2026-06-17T00:57:00-04:00",
"dawn": "2026-06-17T04:51:00-04:00",
"dusk": "2026-06-17T21:03:00-04:00",
"minchaGedola": "2026-06-17T13:35:00-04:00",
"minchaGedolaBaalHatanya": "2026-06-17T13:35:00-04:00",
"minchaGedolaMGA": "2026-06-17T13:41:00-04:00",
"minchaKetana": "2026-06-17T17:21:00-04:00",
"minchaKetanaBaalHatanya": "2026-06-17T17:24:00-04:00",
"minchaKetanaMGA": "2026-06-17T18:03:00-04:00",
"misheyakir": "2026-06-17T04:12:00-04:00",
"misheyakirMachmir": "2026-06-17T04:22:00-04:00",
"plagHaMincha": "2026-06-17T18:55:00-04:00",
"plagHaminchaBaalHatanya": "2026-06-17T18:59:00-04:00",
"sofZmanShma": "2026-06-17T09:11:00-04:00",
"sofZmanShmaBaalHatanya": "2026-06-17T09:08:00-04:00",
"sofZmanShmaMGA": "2026-06-17T08:35:00-04:00",
"sofZmanShmaMGA16Point1": "2026-06-17T08:16:00-04:00",
"sofZmanShmaMGA19Point8": "2026-06-17T07:59:00-04:00",
"sofZmanTfilaBaalHatanya": "2026-06-17T10:25:00-04:00",
"sofZmanTfilla": "2026-06-17T10:26:00-04:00",
"sofZmanTfillaMGA": "2026-06-17T10:02:00-04:00",
"sofZmanTfillaMGA16Point1": "2026-06-17T09:50:00-04:00",
"sofZmanTfillaMGA19Point8": "2026-06-17T09:38:00-04:00",
"sunrise": "2026-06-17T05:24:00-04:00",
"sunset": "2026-06-17T20:30:00-04:00",
"tzaisBaalHatanya": "2026-06-17T21:03:00-04:00",
"tzeit42min": "2026-06-17T21:12:00-04:00",
"tzeit50min": "2026-06-17T21:20:00-04:00",
"tzeit7083deg": "2026-06-17T21:10:00-04:00",
"tzeit72min": "2026-06-17T21:42:00-04:00",
"tzeit85deg": "2026-06-17T21:20:00-04:00"
}
}Get Shabbat times
Get one week's candle lighting, Torah portion and Havdalah for a place, pulled apart into fields a message can use directly. Leave the date empty for this week; give any day to get the week that contains it.
Inputs
- City search
city_searchtext - Type a city name or a US ZIP code here, then choose the exact place from the City list below.
- City
locationtext - The place these times are for. Fill in the city search above and this list fills with the matching cities and ZIP codes. Leave both empty only if you are giving a latitude and longitude instead.
- Latitude
latitudenumber - Latitude in degrees, for a place that is not a city on the list. Needs a longitude and a time zone as well.From -90.0 to 90.0.
- Longitude
longitudenumber - Longitude in degrees, for a place that is not a city on the list. Needs a latitude and a time zone as well.From -180.0 to 180.0.
- Time zone
time_zonetext - The time zone of the latitude and longitude above. Not needed when a city is chosen, since a city already carries its own.
- Elevation in metres
elevationnumber - Height above sea level, which moves sunrise and sunset in hill country. Leave empty to ignore elevation, as most communities do.From 1 to 9000.
- Any day in the week
date_in_weekdate - Any day of the week you want. Leave empty for this week.
- Candle lighting, minutes before sunset
candle_lighting_minutesnumber - How long before sunset candles are lit. Leave empty to use the local custom, which is 18 minutes in most places, 40 in Jerusalem and 30 in Haifa.From 0 to 120.
- Havdalah
havdalahtext - When Shabbat and festivals end.One of:
nightfall(At nightfall, when three small stars are out),42(42 minutes after sunset, for three medium stars),50(50 minutes after sunset, for three small stars),72(72 minutes after sunset, following Rabbeinu Tam),none(Do not include Havdalah). Default:nightfall. - Include the Torah reading
include_torah_readingtrue/false - Also return the verses and haftarah of the week's portion, not only its name.Default:
true. - Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
candle_lightingtextcandle_lighting_attextendtexthaftarahtexthavdalahtexthavdalah_attextholidayslistlocationtextparashatextparasha_hebrewtextstarttexttime_zonetexttorahtext
Example output
{
"candle_lighting": "19:16",
"candle_lighting_at": "2026-08-28T19:16:00-04:00",
"end": "2026-08-29",
"haftarah": "Isaiah 60:1-22",
"havdalah": "20:15",
"havdalah_at": "2026-08-29T20:15:00-04:00",
"holidays": [
{
"category": "roshchodesh",
"date": "2026-08-14",
"hebrew_date": "1 Elul 5786",
"title": "Rosh Chodesh Elul"
}
],
"location": "New York City, New York, USA",
"parasha": "Parashat Ki Tavo",
"parasha_hebrew": "\u05e4\u05e8\u05e9\u05ea \u05db\u05d9\u05be\u05ea\u05d1\u05d5\u05d0",
"start": "2026-08-28",
"time_zone": "America/New_York",
"torah": "Deuteronomy 26:1-29:8"
}List candle lighting times
List candle lighting and Havdalah times for a place over a date range. Covers every Friday and every festival eve in the range, not only Shabbat, and says which occasion each lighting belongs to. Each time comes back both as the local clock time and as a full timestamp.
Inputs
- From date
start_datedate - The first day to cover. Leave this and the other date fields empty for the current year.
- To date
end_datedate - The last day to cover, at most 180 days after the first. Leave empty to cover just the one day.
- City search
city_searchtext - Type a city name or a US ZIP code here, then choose the exact place from the City list below.
- City
locationtext - The place these times are for. Fill in the city search above and this list fills with the matching cities and ZIP codes. Leave both empty only if you are giving a latitude and longitude instead.
- Latitude
latitudenumber - Latitude in degrees, for a place that is not a city on the list. Needs a longitude and a time zone as well.From -90.0 to 90.0.
- Longitude
longitudenumber - Longitude in degrees, for a place that is not a city on the list. Needs a latitude and a time zone as well.From -180.0 to 180.0.
- Time zone
time_zonetext - The time zone of the latitude and longitude above. Not needed when a city is chosen, since a city already carries its own.
- Elevation in metres
elevationnumber - Height above sea level, which moves sunrise and sunset in hill country. Leave empty to ignore elevation, as most communities do.From 1 to 9000.
- Candle lighting, minutes before sunset
candle_lighting_minutesnumber - How long before sunset candles are lit. Leave empty to use the local custom, which is 18 minutes in most places, 40 in Jerusalem and 30 in Haifa.From 0 to 120.
- Havdalah
havdalahtext - When Shabbat and festivals end.One of:
nightfall(At nightfall, when three small stars are out),42(42 minutes after sunset, for three medium stars),50(50 minutes after sunset, for three small stars),72(72 minutes after sunset, following Rabbeinu Tam),none(Do not include Havdalah). Default:nightfall. - Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
countnumberendtextlocationtextstarttexttime_zonetexttimeslist
Example output
{
"count": 2,
"end": "2026-09-13",
"location": "New York City, New York, USA",
"start": "2026-09-04",
"time_zone": "America/New_York",
"times": [
{
"date": "2026-09-11",
"hebrew": "\u05d4\u05d3\u05dc\u05e7\u05ea \u05e0\u05e8\u05d5\u05ea",
"kind": "candles",
"occasion": "Erev Rosh Hashana",
"time": "18:53",
"timestamp": "2026-09-11T18:53:00-04:00",
"title": "Candle lighting: 6:53pm"
},
{
"date": "2026-09-13",
"hebrew": "\u05d4\u05d1\u05d3\u05dc\u05d4",
"kind": "havdalah",
"occasion": "Rosh Hashana II",
"time": "19:49",
"timestamp": "2026-09-13T19:49:00-04:00",
"title": "Havdalah: 7:49pm"
}
]
}List daily learning
List the page due each day on any of sixteen daily learning cycles, from Daf Yomi and Mishna Yomi to the two Yerushalmi cycles, the Rambam, Sefer Chofetz Chaim and Pirkei Avot. Every row says which cycle it belongs to and links to the text on Sefaria.
Inputs
- From date
start_datedateRequired - The first day to cover.
- To date
end_datedate - The last day to cover, at most 180 days after the first. Leave empty to cover just the one day.
- Learning cycles
scheduleslist - Which cycles to include. Leaving this empty returns Daf Yomi.One or more of:
daf_yomi(Daf Yomi: a page of Talmud Bavli a day),daf_a_week(Daf-a-Week: a page of Talmud Bavli a week),mishna_yomi(Mishna Yomi: two mishnayot a day),nach_yomi(Nach Yomi: a chapter of the Prophets and Writings a day),yerushalmi_vilna(Yerushalmi Yomi (Vilna edition)),yerushalmi_schottenstein(Yerushalmi Yomi (Schottenstein edition)),tanakh_yomi(Tanakh Yomi: the Bible on a yearly cycle),daily_psalms(Daily Tehillim: the Psalms on a monthly cycle),rambam_1_chapter(Daily Rambam: one chapter a day),rambam_3_chapters(Daily Rambam: three chapters a day), and 6 more. - Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
countnumberendtextentriesliststarttext
Example output
{
"count": 2,
"end": "2026-06-07",
"entries": [
{
"date": "2026-06-07",
"hebrew": "\u05d7\u05d5\u05dc\u05d9\u05df \u05d3\u05e3 \u05dc\u05f4\u05d7",
"hebrew_date": "22 Sivan 5786",
"link": "https://www.sefaria.org/Chullin.38a",
"schedule": "Daf Yomi",
"title": "Chullin 38"
},
{
"date": "2026-06-07",
"hebrew": "\u05db\u05dc\u05d9\u05dd 9:1-2",
"hebrew_date": "22 Sivan 5786",
"link": "https://www.sefaria.org/Mishnah_Kelim.9.1-2",
"schedule": "Mishna Yomi",
"title": "Kelim 9:1-2"
}
],
"start": "2026-06-07"
}List days of the Omer
List the count of the Omer, the forty-nine days between Pesach and Shavuot, with the wording of each night's count and the sefirah the day belongs to. A range outside the Omer answers with nothing rather than an error.
Inputs
- From date
start_datedate - The first day to cover. Leave this and the other date fields empty for the current year.
- To date
end_datedate - The last day to cover, at most 180 days after the first. Leave empty to cover just the one day.
- Hebrew year
hebrew_yearnumber - A whole Hebrew year to cover instead of a date range, for example 5786. A Hebrew year runs from Rosh Hashana to Rosh Hashana, so it spans parts of two Gregorian years.From 1 to 9999.
- Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
countnumberdayslistendtextstarttext
Example output
{
"count": 1,
"days": [
{
"count": "Today is 1 day of the Omer",
"date": "2026-04-03",
"day": 1,
"hebrew": "\u05e2\u05d5\u05de\u05e8 \u05d9\u05d5\u05dd 1",
"hebrew_date": "16 Nisan 5786",
"link": "https://hebcal.com/o/5786/1",
"sefira": "Chesed sheb'Chesed",
"sefira_meaning": "Lovingkindness within Lovingkindness",
"title": "1st day of the Omer"
}
],
"end": "2026-04-04",
"start": "2026-04-03"
}List halachic times for a date range
Get the zmanim of every day in a range at a place, one row per day. Up to 180 days at a time.
Inputs
- From date
start_datedateRequired - The first day to cover.
- To date
end_datedate - The last day to cover, at most 180 days after the first. Leave empty to cover just the one day.
- City search
city_searchtext - Type a city name or a US ZIP code here, then choose the exact place from the City list below.
- City
locationtext - The place these times are for. Fill in the city search above and this list fills with the matching cities and ZIP codes. Leave both empty only if you are giving a latitude and longitude instead.
- Latitude
latitudenumber - Latitude in degrees, for a place that is not a city on the list. Needs a longitude and a time zone as well.From -90.0 to 90.0.
- Longitude
longitudenumber - Longitude in degrees, for a place that is not a city on the list. Needs a latitude and a time zone as well.From -180.0 to 180.0.
- Time zone
time_zonetext - The time zone of the latitude and longitude above. Not needed when a city is chosen, since a city already carries its own.
- Elevation in metres
elevationnumber - Height above sea level, which moves sunrise and sunset in hill country. Leave empty to ignore elevation, as most communities do.From 1 to 9000.
- Include seconds
include_secondstrue/false - Return times to the second instead of rounding to the nearest minute.Default:
false.
Outputs
countnumberdayslistendtextlocationtextstarttexttime_zonetext
Example output
{
"count": 1,
"days": [
{
"date": "2026-06-17",
"times": {
"alosBaalHatanya": "2026-06-17T03:28:00-04:00",
"alotHaShachar": "2026-06-17T03:35:00-04:00",
"beinHaShmashos": "2026-06-17T20:57:00-04:00",
"chatzot": "2026-06-17T12:57:00-04:00",
"chatzotNight": "2026-06-17T00:57:00-04:00",
"dawn": "2026-06-17T04:51:00-04:00",
"dusk": "2026-06-17T21:03:00-04:00",
"minchaGedola": "2026-06-17T13:35:00-04:00",
"minchaGedolaBaalHatanya": "2026-06-17T13:35:00-04:00",
"minchaGedolaMGA": "2026-06-17T13:41:00-04:00",
"minchaKetana": "2026-06-17T17:21:00-04:00",
"minchaKetanaBaalHatanya": "2026-06-17T17:24:00-04:00",
"minchaKetanaMGA": "2026-06-17T18:03:00-04:00",
"misheyakir": "2026-06-17T04:12:00-04:00",
"misheyakirMachmir": "2026-06-17T04:22:00-04:00",
"plagHaMincha": "2026-06-17T18:55:00-04:00",
"plagHaminchaBaalHatanya": "2026-06-17T18:59:00-04:00",
"sofZmanShma": "2026-06-17T09:11:00-04:00",
"sofZmanShmaBaalHatanya": "2026-06-17T09:08:00-04:00",
"sofZmanShmaMGA": "2026-06-17T08:35:00-04:00",
"sofZmanShmaMGA16Point1": "2026-06-17T08:16:00-04:00",
"sofZmanShmaMGA19Point8": "2026-06-17T07:59:00-04:00",
"sofZmanTfilaBaalHatanya": "2026-06-17T10:25:00-04:00",
"sofZmanTfilla": "2026-06-17T10:26:00-04:00",
"sofZmanTfillaMGA": "2026-06-17T10:02:00-04:00",
"sofZmanTfillaMGA16Point1": "2026-06-17T09:50:00-04:00",
"sofZmanTfillaMGA19Point8": "2026-06-17T09:38:00-04:00",
"sunrise": "2026-06-17T05:24:00-04:00",
"sunset": "2026-06-17T20:30:00-04:00",
"tzaisBaalHatanya": "2026-06-17T21:03:00-04:00",
"tzeit42min": "2026-06-17T21:12:00-04:00",
"tzeit50min": "2026-06-17T21:20:00-04:00",
"tzeit7083deg": "2026-06-17T21:10:00-04:00",
"tzeit72min": "2026-06-17T21:42:00-04:00",
"tzeit85deg": "2026-06-17T21:20:00-04:00"
}
}
],
"end": "2026-06-17",
"location": "New York City, New York, USA",
"start": "2026-06-17",
"time_zone": "America/New_York"
}List Hebrew dates for a date range
Convert every day in a date range to its Hebrew date, with the weekday and any holiday or Torah portion falling on it. Up to 180 days at a time.
Inputs
- From date
start_datedateRequired - The first day to cover.
- To date
end_datedate - The last day to cover, at most 180 days after the first. Leave empty to cover just the one day.
- Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
countnumberdateslistendtextstarttext
Example output
{
"count": 2,
"dates": [
{
"day_of_week": "Friday",
"events": [
"Erev Rosh Hashana"
],
"gregorian_date": "2026-09-11",
"hebrew": "\u05db\u05f4\u05d8 \u05d1\u05b6\u05bc\u05d0\u05b1\u05dc\u05d5\u05bc\u05dc \u05ea\u05e9\u05e4\u05f4\u05d5",
"hebrew_date": "29 Elul 5786",
"hebrew_day": 29,
"hebrew_month": "Elul",
"hebrew_year": 5786
},
{
"day_of_week": "Saturday",
"events": [
"Rosh Hashana 5787"
],
"gregorian_date": "2026-09-12",
"hebrew": "\u05d0\u05f3 \u05d1\u05b0\u05bc\u05ea\u05b4\u05e9\u05b0\u05c1\u05e8\u05b5\u05d9 \u05ea\u05e9\u05e4\u05f4\u05d6",
"hebrew_date": "1 Tishrei 5787",
"hebrew_day": 1,
"hebrew_month": "Tishrei",
"hebrew_year": 5787
}
],
"end": "2026-09-12",
"start": "2026-09-11"
}List Jewish holidays
List Jewish holidays over a date range or a whole Hebrew year. Choose which groups to include: the major festivals, the minor holidays, the modern Israeli observances, Rosh Chodesh, the minor fasts, the special Shabbatot, Yom Kippur Katan, Shabbat Mevarchim, the molad and the Yizkor dates. Narrow it to Yom Tov only for the days on which work is forbidden, which is the list a business calendar needs.
Inputs
- From date
start_datedate - The first day to cover. Leave this and the other date fields empty for the current year.
- To date
end_datedate - The last day to cover, at most 180 days after the first. Leave empty to cover just the one day.
- Hebrew year
hebrew_yearnumber - A whole Hebrew year to cover instead of a date range, for example 5786. A Hebrew year runs from Rosh Hashana to Rosh Hashana, so it spans parts of two Gregorian years.From 1 to 9999.
- Holidays to include
holiday_typeslist - Which groups of holidays to list. Leaving this empty returns the six groups a Jewish calendar shows by default.One or more of:
major(Major holidays: Rosh Hashana, Yom Kippur, Pesach),minor(Minor holidays: Tu BiShvat, Lag BaOmer, Purim Katan),modern(Modern holidays: Yom HaAtzmaut, Yom HaShoah),rosh_chodesh(Rosh Chodesh: the start of each Hebrew month),minor_fasts(Minor fasts: Tzom Gedaliah, Ta'anit Esther),special_shabbatot(Special Shabbatot: Shabbat Zachor, Shabbat HaGadol),yom_kippur_katan(Yom Kippur Katan),shabbat_mevarchim(Shabbat Mevarchim: the Shabbat before a new month),molad(Molad: the moment of each new moon),yizkor(Yizkor: the four memorial service dates). - Only Yom Tov
yom_tov_onlytrue/false - Narrow the answer to the festival days on which work is forbidden, which is the list a business calendar needs. This replaces the groups chosen above.Default:
false. - Include every Hebrew date
include_hebrew_datestrue/false - Also return an entry for every day in the range carrying its Hebrew date, not only the days that have a holiday.Default:
false. - Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
countnumberendtextholidaysliststarttext
Example output
{
"count": 2,
"end": "2026-09-14",
"holidays": [
{
"category": "holiday",
"date": "2026-09-11",
"hebrew": "\u05e2\u05e8\u05d1 \u05e8\u05d0\u05e9 \u05d4\u05e9\u05e0\u05d4",
"hebrew_date": "29 Elul 5786",
"link": "https://hebcal.com/h/rosh-hashana-2026",
"memo": "The Jewish New Year. Also spelled Rosh Hashanah",
"subcategory": "major",
"title": "Erev Rosh Hashana"
},
{
"category": "holiday",
"date": "2026-09-12",
"hebrew": "\u05e8\u05d0\u05e9 \u05d4\u05e9\u05e0\u05d4 5787",
"hebrew_date": "1 Tishrei 5787",
"link": "https://hebcal.com/h/rosh-hashana-2026",
"memo": "The Jewish New Year. Also spelled Rosh Hashanah",
"subcategory": "major",
"title": "Rosh Hashana 5787"
}
],
"start": "2026-09-11"
}List ordinary dates from a Hebrew date
Convert a run of days starting from a Hebrew date to ordinary calendar dates. The counterpart of 'List Hebrew dates for a date range' for someone who knows the Hebrew date they are starting from, such as the first of a month.
Inputs
- Hebrew year
hebrew_yearnumberRequired - The Hebrew year, for example 5786.From 1 to 9999.
- Hebrew month
hebrew_monthtextRequired - The Hebrew month. In a leap year Adar means Adar II; in an ordinary year all three Adars are the same month.One of:
Nisan(Nisan: March or April),Iyyar(Iyyar: April or May),Sivan(Sivan: May or June),Tamuz(Tamuz: June or July),Av(Av: July or August),Elul(Elul: August or September),Tishrei(Tishrei: September or October),Cheshvan(Cheshvan: October or November),Kislev(Kislev: November or December),Tevet(Tevet: December or January), and 4 more. - Hebrew day of the month
hebrew_daynumberRequired - The day of the Hebrew month, 1 to 30.From 1 to 30.
- Number of days
daysnumber - How many days to convert, counting from the Hebrew date above.From 2 to 180. Default:
30. - Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
countnumberdateslistendtextstarttext
Example output
{
"count": 2,
"dates": [
{
"day_of_week": "Monday",
"events": [
"Chanukah day 1",
"Parashat Miketz"
],
"gregorian_date": "2025-12-15",
"hebrew": "\u05db\u05f4\u05d4 \u05d1\u05b0\u05bc\u05db\u05b4\u05e1\u05b0\u05dc\u05b5\u05d5 \u05ea\u05e9\u05e4\u05f4\u05d5",
"hebrew_date": "25 Kislev 5786",
"hebrew_day": 25,
"hebrew_month": "Kislev",
"hebrew_year": 5786
},
{
"day_of_week": "Tuesday",
"events": [
"Chanukah day 2",
"Parashat Miketz"
],
"gregorian_date": "2025-12-16",
"hebrew": "\u05db\u05f4\u05d5 \u05d1\u05b0\u05bc\u05db\u05b4\u05e1\u05b0\u05dc\u05b5\u05d5 \u05ea\u05e9\u05e4\u05f4\u05d5",
"hebrew_date": "26 Kislev 5786",
"hebrew_day": 26,
"hebrew_month": "Kislev",
"hebrew_year": 5786
}
],
"end": "2025-12-16",
"start": "2025-12-15"
}List Torah readings for a date range
List every Torah reading occasion in a date range, with the verses read for each. Covers more than the Shabbat portions: holiday readings, Rosh Chodesh and the Monday and Thursday weekday readings all appear. Up to 180 days at a time.
Inputs
- From date
start_datedateRequired - The first day to cover.
- To date
end_datedate - The last day to cover, at most 180 days after the first. Leave empty to cover just the one day.
- Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Include the triennial cycle
include_triennialtrue/false - Also return the triennial reading, the third of the portion many Conservative congregations read. Available from Hebrew year 5745 on.Default:
true.
Outputs
countnumberendtextreadingsliststarttext
Example output
{
"count": 2,
"end": "2026-09-24",
"readings": [
{
"aliyah_count": 7,
"date": "2026-09-21",
"haftarah": "Isaiah 57:14-58:14",
"hebrew": "\u05d9\u05d5\u05b9\u05dd \u05db\u05b4\u05bc\u05e4\u05bc\u05d5\u05bc\u05e8",
"hebrew_date": "10 Tishrei 5787",
"name": "Yom Kippur",
"summary": "Leviticus 16:1-34; Numbers 29:7-11",
"triennial_year": null,
"type": "holiday"
},
{
"aliyah_count": 3,
"date": "2026-09-24",
"haftarah": "",
"hebrew": "\u05d5\u05b0\u05d6\u05b9\u05d0\u05ea \u05d4\u05b7\u05d1\u05b0\u05bc\u05e8\u05b8\u05db\u05b8\u05d4",
"hebrew_date": "13 Tishrei 5787",
"name": "Vezot Haberakhah",
"summary": "Deuteronomy 33:1-17",
"triennial_year": null,
"type": "weekday"
}
],
"start": "2026-09-21"
}List weekly Torah portions
List Parashat ha-Shavua week by week over a date range or a whole Hebrew year, with the verses read, the haftarah and the maftir for each. Israel and the Diaspora fall out of step for a few months after each Pesach, so the schedule follows whichever was chosen.
Inputs
- From date
start_datedate - The first day to cover. Leave this and the other date fields empty for the current year.
- To date
end_datedate - The last day to cover, at most 180 days after the first. Leave empty to cover just the one day.
- Hebrew year
hebrew_yearnumber - A whole Hebrew year to cover instead of a date range, for example 5786. A Hebrew year runs from Rosh Hashana to Rosh Hashana, so it spans parts of two Gregorian years.From 1 to 9999.
- Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false. - Event language
languagetext - How event names are written. The default is the Sephardic transliteration used on hebcal.com.One of:
s(Sephardic transliteration, for example Shabbat),a(Ashkenazic transliteration, for example Shabbos),he(Hebrew),he-x-NoNikud(Hebrew without vowel marks),sh(Sephardic transliteration with Hebrew),ah(Ashkenazic transliteration with Hebrew),ashkenazi_standard(Ashkenazic transliteration (standard)),ashkenazi_litvish(Ashkenazic transliteration (Litvish)),ashkenazi_poylish(Ashkenazic transliteration (Poylish)),ashkenazi_romanian(Ashkenazic transliteration (Romanian)), and 11 more. Default:s.
Outputs
countnumberendtextportionsliststarttext
Example output
{
"count": 1,
"end": "2026-09-19",
"portions": [
{
"date": "2026-09-05",
"haftarah": "Isaiah 61:10-63:9",
"hebrew": "\u05e4\u05e8\u05e9\u05ea \u05e0\u05e6\u05d1\u05d9\u05dd\u05be\u05d5\u05d9\u05dc\u05da",
"hebrew_date": "23 Elul 5786",
"link": "https://hebcal.com/s/5786/51d",
"maftir": "Deuteronomy 31:28-31:30",
"name": "Parashat Nitzavim-Vayeilech",
"torah": "Deuteronomy 29:9-31:30"
}
],
"start": "2026-09-05"
}List yahrzeit and anniversary dates
Work out the Hebrew anniversaries of a date for a run of years. A yahrzeit, a Hebrew birthday or a Hebrew wedding anniversary falls on the Hebrew date of the original event, which drifts against the ordinary calendar by a couple of weeks each year. Give the date it happened on and this returns the observance date for each year, optionally with the four Yizkor dates of each year alongside. Add more people to build one calendar covering a whole family.
Inputs
- Name
nametextRequired - Whose anniversary this is. It appears in the title of every date returned.
- Occasion
occasiontext - What kind of anniversary this is.One of:
Yahrzeit(Yahrzeit: the anniversary of a death),Birthday(Hebrew birthday),Anniversary(Hebrew wedding anniversary),Other(Another yearly occasion). Default:Yahrzeit. - Date it happened
gregorian_datedate - The ordinary calendar date of the death, birth or wedding. Fill in this or the Hebrew date below, not both.
- It happened after sunset
after_sunsettrue/false - Turn this on if it happened after sunset, which puts it on the next Hebrew date and moves every anniversary with it.Default:
false. - Hebrew year it happened
hebrew_yearnumber - The Hebrew year of the event, if that is how it is recorded. Needs the Hebrew month and day as well, and replaces the ordinary date above.From 1 to 9999.
- Hebrew month it happened
hebrew_monthtext - The Hebrew month of the event.One of:
Nisan(Nisan: March or April),Iyyar(Iyyar: April or May),Sivan(Sivan: May or June),Tamuz(Tamuz: June or July),Av(Av: July or August),Elul(Elul: August or September),Tishrei(Tishrei: September or October),Cheshvan(Cheshvan: October or November),Kislev(Kislev: November or December),Tevet(Tevet: December or January), and 4 more. - Hebrew day it happened
hebrew_daynumber - The day of the Hebrew month, 1 to 30.From 1 to 30.
- More people
more_peoplelist - Anyone else to put on the same calendar. Each entry needs a name and a date, and takes the same fields as above: name, occasion, date, after_sunset, or hebrew_year, hebrew_month and hebrew_day.
- Years to cover
yearsnumber - How many Hebrew years of anniversaries to work out.From 1 to 120. Default:
20. - Start at Hebrew year
start_hebrew_yearnumber - The first Hebrew year to cover. Leave empty to start from the current one.From 1 to 9999.
- End at Hebrew year
end_hebrew_yearnumber - The last Hebrew year to cover, counted inclusively. Needs a first year above to count from. Leave empty to use the number of years instead.From 1 to 9999.
- Include Yizkor dates
include_yizkortrue/false - Also return the four days each year on which Yizkor is said: Yom Kippur, Shmini Atzeret, the last day of Pesach and Shavuot.Default:
false. - Put the Hebrew date in the title
include_hebrew_datetrue/false - Append the Hebrew date to each title, so a calendar entry reads its Hebrew date without a second field.Default:
false. - Use the Israel schedule
israeltrue/false - Israel keeps one day of each festival where the Diaspora keeps two, which also puts the two Torah reading cycles out of step for a few months after each Pesach. Turn this on for Israel.Default:
false.
Outputs
countnumberendtexteventsliststarttexttitletext
Example output
{
"count": 2,
"end": "2027-06-12",
"events": [
{
"anniversary": null,
"category": "yizkor",
"date": "2025-10-02",
"hebrew_date": "10 Tishrei 5786",
"memo": "",
"name": "",
"title": "Yizkor (Yom Kippur)"
},
{
"anniversary": 78,
"category": "yahrzeit",
"date": "2026-03-25",
"hebrew_date": "7 Nisan 5786",
"memo": "Hebcal joins you in remembering Sarah Cohen.",
"name": "Sarah Cohen",
"title": "Sarah Cohen's 78th Yahrzeit"
}
],
"start": "2025-10-02",
"title": "Yahrzeit: Sarah Cohen"
}