n8n-nodes-shabbat-time

An n8n community node to check if a given date falls on Shabbat or Jewish holiday using the Hebcal API.

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-shabbat-time

Features

• ✅ Check if a specific date falls on Shabbat
• ✅ Check if a specific date falls on Jewish holidays (major and minor)
• ✅ Support for multiple location formats (GeoNames ID, coordinates, ZIP code)
• ✅ Configurable candle lighting time
• ✅ Detailed information about Jewish events on the given date
• ✅ Usable as AI Tool in n8n agents

Operations

Check Date

Checks if a given date falls on Shabbat or Jewish holiday.

Input Parameters:

• Date: The date to check (date/time picker)
• Location Type: Choose between GeoNames ID, coordinates, or ZIP code
• GeoNames ID: Numeric ID from GeoNames.org (default: 281184 for Jerusalem)
• Latitude/Longitude: Geographic coordinates (default: Jerusalem)
• ZIP Code: US ZIP code for location
• Include Minor Holidays: Whether to include minor holidays like Rosh Chodesh
• Candle Lighting Minutes: Minutes before sunset for candle lighting (default: 18, Jerusalem: 40)

Output:

• isShabbatOrHoliday: Boolean indicating if the date is Shabbat or holiday
• inputDate: The original input date
• formattedDate: Date in YYYY-MM-DD format
• dayOfWeek: Day of the week in English
• categories: Array of event categories found for this date
• details: Detailed information about events on this date
• location: Location information from Hebcal

Usage Examples

Basic Usage

1. Add the Shabbat Time node to your workflow
2. Select "Check Date" operation
3. Set the date you want to check
4. Choose your location (default: Jerusalem)
5. Execute the workflow

Example Output

{
  "isShabbatOrHoliday": true,
  "inputDate": "2024-12-14T00:00:00.000Z",
  "formattedDate": "2024-12-14",
  "dayOfWeek": "Saturday",
  "categories": ["candles", "parashat", "havdalah"],
  "details": [
    {
      "title": "Candle lighting: 4:01pm",
      "category": "candles",
      "hebrew": "הדלקת נרות",
      "date": "2024-12-13T16:01:00-05:00"
    },
    {
      "title": "Parashat Vayeshev",
      "category": "parashat",
      "hebrew": "פרשת וישב",
      "date": "2024-12-14"
    }
  ],
  "location": {
    "title": "Jerusalem, Jerusalem District, Israel",
    "city": "Jerusalem",
    "tzid": "Asia/Jerusalem",
    "latitude": 31.76904,
    "longitude": 35.21633
  }
}

Categories Detected

The node detects the following categories as Shabbat or holidays:

• candles - Candle lighting (Friday evening or holiday eve)
• havdalah - Havdalah (end of Shabbat)
• parashat - Weekly Torah portion (Shabbat)
• holiday - Jewish holidays
• roshchodesh - Rosh Chodesh (if minor holidays enabled)
• fast - Fast days (if minor holidays enabled)

Location Options

GeoNames ID (Recommended)

Use the numeric ID from GeoNames.org for precise location data.

Common GeoNames IDs:

• Jerusalem: 281184
• Tel Aviv: 293397
• New York: 5128581
• London: 2643743
• Los Angeles: 5368361

Coordinates

Provide latitude and longitude for any location worldwide.

ZIP Code

Use US ZIP codes for locations within the United States.

API Reference

This node uses the Hebcal Shabbat Times REST API.

Compatibility

• n8n version: 1.0.0 or later
• Node.js version: 20.15 or later

License

MIT

Credits

• Powered by Hebcal.com API
• Jewish calendar calculations by Hebcal

Support

For issues and feature requests, please visit the GitHub repository.

Contributing

Contributions are welcome! Please read the contributing guidelines and submit pull requests.