Shabbat Time icon

Shabbat Time

Check if a given date falls on Shabbat or Jewish holiday using Hebcal API

Actions3

Check Date

AI-generated

Overview

This node checks if a given date falls on Shabbat or a Jewish holiday using the Hebcal API. It is useful for applications that need to determine Jewish observance days, such as scheduling events, sending notifications, or planning activities around these dates. For example, it can be used to verify if a date is a Shabbat or holiday in a specific location like Tel Aviv or Jerusalem, or a custom location defined by coordinates or ZIP code.

Use Case Examples

  1. Check if a specific date is Shabbat or a Jewish holiday in Tel Aviv.
  2. Determine if a date falls within Shabbat times including candle lighting and Havdalah times.
  3. Include minor holidays and modern Israeli holidays in the check for a given date.

Properties

Name Meaning
Date The date to check if it falls on Shabbat or a Jewish holiday.
Location Predefined or custom location to determine the relevant Shabbat or holiday times.
Custom Location Type Type of custom location identifier used when 'Custom Location' is selected.
GeoNames ID GeoNames.org numeric ID for the custom location.
Latitude Latitude coordinate for the custom location (-90 to 90).
Longitude Longitude coordinate for the custom location (-180 to 180).
ZIP Code United States ZIP code for the custom location (5 digits).
Include Minor Holidays Whether to include minor Jewish holidays such as Rosh Chodesh, Tu BiShvat, Lag BaOmer, and minor fasts.
Include Chol Hamoed Whether to include intermediate festival days during Passover and Sukkot, and modern Israeli holidays like Yom HaShoah and Yom HaAtzmaut.
Check Exact Time Whether to check the exact time for Shabbat/holiday entry and exit instead of just the date.
Candle Lighting Minutes Minutes before sunset for candle lighting (default 18, Jerusalem 40).

Output

JSON

  • isShabbatOrHoliday - Boolean indicating if the date is Shabbat or a Jewish holiday.
  • dayOfWeek - Day of the week for the checked date.
  • checkExactTime - Boolean indicating if exact time checking was used.
  • location
    • city - City name of the location used for the check.
    • tzid - Time zone identifier of the location.
    • country - Country of the location.
    • geonameid - GeoNames ID of the location.
  • sabbatTimes
    • candleLighting - Date and time of candle lighting for Shabbat or holiday.
    • havdalah - Date and time of Havdalah marking the end of Shabbat or holiday.
    • isInShabbatTimeRange - Boolean indicating if the checked time is within Shabbat time range.

Dependencies

  • Hebcal API for Jewish calendar data

Troubleshooting

  • Invalid date input: Ensure the date is valid and within the range 1900 to 2100.
  • Unknown city error: Verify the selected location is supported or provide a valid custom location.
  • Latitude and longitude validation: Latitude must be between -90 and 90, longitude between -180 and 180.
  • ZIP code requirement: When using ZIP code as custom location type, a valid 5-digit ZIP code must be provided.
  • API request failures: Check network connectivity and API availability.

Links

Discussion