hebrew-calendar

Package Information

Released: 7/6/2025
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.0
Author: ovadiab9

Documentation

n8n-nodes-hebrew-calendar

npm version
License: MIT

An n8n community node for Hebrew/Jewish calendar operations. This node allows you to check if dates are Shabbat, Jewish holidays, or Chol Hamoed (intermediate festival days), and provides accurate candle lighting and Havdalah times.

Features

  • Check Date Status: Determine if a specific date and time is Shabbat, a Jewish holiday, or Chol Hamoed
  • Time-Aware Checking: Validate exact times against Shabbat entry/exit times
  • Shabbat Times: Get precise candle lighting and Havdalah times for any location
  • Holiday Information: Retrieve comprehensive Jewish holiday data for date ranges
  • Multiple Locations: Support for major Israeli cities with accurate sunset/sunrise calculations
  • Customizable Options: Configure Chol Hamoed inclusion, candle lighting minutes, and more

Installation

To install this node in your n8n instance:

npm install n8n-nodes-hebrew-calendar

Usage

Operations

1. Check Date Status

Checks if a specific date (and optionally time) is a special day in the Jewish calendar.

Parameters:

  • Target Date: Date to check (YYYY-MM-DD format)
  • Check Specific Time: Enable to check exact time against Shabbat hours
  • Target Time: Time to check (HH:MM format) - only if "Check Specific Time" is enabled
  • Include Chol Hamoed: Whether to consider intermediate festival days as special days
  • Location: Location for sunset/sunrise calculations (defaults to Tel Aviv)

Example Output:

{
  "date": "2024-01-20",
  "time": "19:30",
  "location": "Tel Aviv",
  "isShabbat": true,
  "isHoliday": false,
  "isCholHamoed": false,
  "isSpecialDay": true,
  "eventType": "shabbat",
  "timeBasedResult": true,
  "candleLighting": "2024-01-19T16:45:00+02:00",
  "havdalah": "2024-01-20T17:55:00+02:00"
}

2. Get Shabbat Times

Retrieves candle lighting and Havdalah times for a specific date.

Parameters:

  • Target Date: Date to get times for
  • Location: Location for calculations

Example Output:

{
  "date": "2024-01-20",
  "location": "Tel Aviv",
  "candleLighting": {
    "time": "2024-01-19T16:45:00+02:00",
    "title": "Candle lighting: 4:45pm"
  },
  "havdalah": {
    "time": "2024-01-20T17:55:00+02:00",
    "title": "Havdalah: 5:55pm"
  }
}

3. Get Holiday Info

Retrieves comprehensive Jewish holiday information for a date range.

Parameters:

  • Start Date: Beginning of date range
  • End Date: End of date range
  • Include Chol Hamoed: Whether to include intermediate festival days

Supported Locations

  • Tel Aviv (default)
  • Jerusalem
  • Haifa
  • Netanya
  • Ashdod
  • Rishon LeZion
  • Petah Tikva
  • Beersheba
  • Holon
  • Bnei Brak

Use Cases

  • Scheduling Systems: Avoid scheduling meetings during Shabbat or holidays
  • E-commerce: Adjust delivery schedules for observant customers
  • Event Planning: Coordinate events around Jewish calendar dates
  • Automation: Create workflows that respect Jewish time observances
  • Notifications: Send reminders for candle lighting times
  • Business Logic: Implement Jewish calendar-aware business rules

API Integration

This node uses the Hebcal.com API for accurate Hebrew calendar data, including:

  • Israeli holiday schedule
  • Precise sunset/sunrise calculations
  • Shabbat and holiday times
  • Multiple location support

Configuration

The node supports various configuration options:

  • Candle Lighting Minutes: Customize minutes before sunset (default: 18, Jerusalem: 40)
  • Havdalah Calculation: Choose between tzeit hakochavim (nightfall) or fixed minutes
  • Holiday Types: Include/exclude minor holidays, fast days, modern holidays
  • Special Shabbatot: Include special Shabbat readings

Development

To contribute to this node:

  1. Clone the repository
  2. Install dependencies: npm install
  3. Build the project: npm run build
  4. Test locally: npm run dev

License

MIT

Support

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

Acknowledgments

  • Hebcal.com for providing the Jewish calendar API
  • n8n for the excellent workflow automation platform

Discussion