Overview
This node provides detailed information about Jewish holidays, Shabbat times, and Hebrew calendar dates for specified locations in Israel. It fetches data from an external Hebrew calendar API to determine holiday occurrences, special days like Chol Hamoed (intermediate festival days), candle lighting and Havdalah times, and other related events within a given date range.
A common use case is for users who want to automate reminders or workflows based on Jewish holidays or Shabbat times, such as sending notifications before candle lighting or checking if a particular date is a holiday or special day. For example, a user could retrieve all holidays between two dates for Tel Aviv and then trigger calendar events or alerts accordingly.
Properties
| Name | Meaning |
|---|---|
| Location | The city/location in Israel for which to calculate holiday and Shabbat times. Options: Ashdod, Beersheba, Bnei Brak, Haifa, Holon, Jerusalem, Netanya, Petah Tikva, Rishon LeZion, Tel Aviv (default). |
| Include Chol Hamoed | Whether to include Chol Hamoed (intermediate festival days) as special days in the results. |
| Start Date | The start date of the range for which to retrieve holiday information, in YYYY-MM-DD format. |
| End Date | The end date of the range for which to retrieve holiday information, in YYYY-MM-DD format. |
| Additional Options | A collection of optional settings: |
| - Candle Lighting Minutes | Number of minutes before sunset to consider for candle lighting time (default 18, 40 for Jerusalem). |
| - Havdalah Minutes | Number of minutes after sunset to consider for Havdalah time (default 0, can be set to fixed values like 42, 50, 72). |
| - Include Fast Days | Whether to include minor fast days in the holiday list. |
| - Include Minor Holidays | Whether to include minor holidays such as Tu BiShvat, Lag BaOmer, etc. |
| - Include Modern Holidays | Whether to include modern Israeli holidays like Yom HaShoah, Yom HaZikaron, etc. |
| - Include Rosh Chodesh | Whether to include Rosh Chodesh (new moon) dates. |
| - Include Special Shabbatot | Whether to include special Shabbatot such as Shekalim, Zachor, etc. |
Output
The output JSON contains detailed information about holidays and special days within the specified date range and location:
dateRange: Object withstartandenddates defining the queried range.location: The selected location name.summary: Summary counts including total events, number of holidays, Shabbatot (Sabbaths), Chol Hamoed days, and other events.holidays: Array of holiday objects occurring in the range (excluding Chol Hamoed if not included).shabbatot: Array of Shabbat-related events.cholHamoed: Array of Chol Hamoed events (if included).other: Array of other events such as minor holidays, fast days, or special Shabbatot depending on options.
Each event object typically includes:
title: Name of the event.category: Event category (e.g., "holiday", "parashat").subcat: Subcategory if applicable.hebrew: Hebrew name of the event.date: Date/time string of the event.
No binary data output is produced by this node.
Dependencies
- Requires internet access to call the external Hebrew calendar API at
https://www.hebcal.com/hebcal. - No internal credentials are required, but the node uses HTTP requests with a custom User-Agent header.
- No additional environment variables or n8n configurations are necessary beyond standard HTTP request capabilities.
Troubleshooting
Common Issues:
- Network errors or timeouts when calling the external API may cause failures.
- Invalid date formats for start or end dates can lead to unexpected results or errors.
- Selecting a location not in the predefined list defaults to Tel Aviv silently.
Error Messages:
"Failed to fetch Hebrew calendar data: <error message>"indicates issues connecting to or receiving data from the external API. Check network connectivity and API availability.- If the node throws errors related to date parsing or missing parameters, verify that required fields like startDate and endDate are correctly formatted and provided.
Resolutions:
- Ensure valid ISO date strings (YYYY-MM-DD) are used.
- Confirm stable internet connection.
- Retry later if the external API is temporarily unavailable.