Hebrew Calendar icon

Hebrew Calendar

Check Hebrew calendar dates, Shabbat times, and Jewish holidays

Actions3

Overview

The "Get Shabbat Times" operation of the Hebrew Calendar node fetches detailed candle lighting and Havdalah times for Shabbat based on a specified date and location in Israel. It queries an external Hebrew calendar API to retrieve accurate Jewish calendar events, focusing on Shabbat-related timings.

This node is beneficial for users who want to automate reminders or workflows around Shabbat observance, such as sending notifications for candle lighting or Havdalah times, scheduling tasks before Shabbat begins, or integrating Jewish calendar data into other applications.

Practical examples:

  • A home automation system that dims lights at candle lighting time.
  • A community app that sends daily Shabbat start and end times.
  • A workflow that adjusts business hours or operations according to Shabbat.

Properties

Name Meaning
Location Select the city/location in Israel for which to calculate Shabbat times. Options include Ashdod, Beersheba, Bnei Brak, Haifa, Holon, Jerusalem, Netanya, Petah Tikva, Rishon LeZion, Tel Aviv (default).
Target Date The specific date (in YYYY-MM-DD format) for which to get Shabbat times. Defaults to the current date.
Additional Options Collection of optional settings:
• Candle Lighting Minutes: Minutes before sunset for candle lighting (default 18, 40 for Jerusalem).
• Havdalah Minutes: Minutes after sunset for Havdalah (default 0 for nightfall, or fixed values like 42, 50, 72).
• Include Fast Days: Whether to include minor fast days (true/false).
• Include Minor Holidays: Whether to include minor holidays like Tu BiShvat, Lag BaOmer (true/false).
• Include Modern Holidays: Whether to include modern Israeli holidays (true/false).
• Include Rosh Chodesh: Whether to include new moon dates (true/false).
• Include Special Shabbatot: Whether to include special Shabbatot like Shekalim, Zachor (true/false).

Output

The output JSON object for the "Get Shabbat Times" operation includes:

  • date: The requested date (YYYY-MM-DD).
  • location: The selected location name.
  • candleLighting: An object with:
    • time: ISO string timestamp of candle lighting time.
    • title: Event title (e.g., "Candle lighting").
    • hebrew: Hebrew text for the event.
  • havdalah: An object with:
    • time: ISO string timestamp of Havdalah time.
    • title: Event title (e.g., "Havdalah").
    • hebrew: Hebrew text for the event.
  • parashat: An object with:
    • title: Name of the weekly Torah portion.
    • hebrew: Hebrew text for the parashat.
  • events: Array of all events returned by the API for that date, each containing:
    • title
    • category (e.g., candles, havdalah, parashat)
    • date (ISO string)
    • hebrew

No binary data is output by this node.

Dependencies

  • The node depends on an external Hebrew calendar API (https://www.hebcal.com/hebcal) to fetch calendar data.
  • Requires internet access from the n8n environment to make HTTP GET requests.
  • No internal credentials are required; the API is accessed anonymously with a user-agent header identifying the node.
  • Timeout for HTTP requests is set to 10 seconds.

Troubleshooting

  • Common issues:

    • Network connectivity problems may cause failures fetching data from the Hebrew calendar API.
    • Invalid date formats can lead to no 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 an HTTP request failure. Check network connection and API availability.
    • If the node returns empty or incomplete event data, verify the input date and location parameters.

  • Resolutions:

    • Ensure the n8n instance has internet access.
    • Use valid ISO date strings (YYYY-MM-DD).
    • Choose a supported location from the dropdown options.

Links and References

Discussion