Posted by & filed under Developers, APIs, RSS Feeds, Source Code.

To display a Jewish calendar on your website, you can use event data from Hebcal.com and the open source JavaScript event calendar from fullcalendar.io.

First, you’ll want to start by including the CSS and JS in your header, per the FullCalendar Basic Usage.

Then, for the events configuration, use a url that references our Jewish calendar REST API, but change cfg=json to cfg=fc.

You won’t need to specify a year=YYYY parameter, as the fullcalendar.io script automatically sends start=YYYY-MM-DD and end=YYYY-MM-DD parameters for you.

For best performance, be sure to use cache: true.

Here’s the FullCalendar invocation:

If you’d like to include candle-lighting times for Shabbat and holidays, be sure to adjust the url parameter to include c=on and one of the location fields (such as geonameid=3448439 for São Paulo, Brazil).

We recommend some specific styles to make the page look prettier:

Here’s a complete example that uses the aforementioned JS + CSS, and also includes the necessary stuff to load FullCalendar.io and dependencies via CDN:

Posted by & filed under Candle lighting.

Hebcal offers a way to specify candle-lighting times location by latitude and longitude for remote or less-populated areas.

Hebcal supports already over 45,000 world cities. Just search for the name of any world city with population 5,000+. However, if you can’t find what you’re looking for in our location database, here’s how you could find candle-lighting times for a specific location.

Example: Ixiamas, Bolivia.

  1. Go to the Getty Thesaurus of Geographic Names at http://www.getty.edu/research/tools/vocabulary/tgn/
  2. Type “Ixiamas” in the Find box and click “Search” button
  3. Click on the link that says “Ixiamas… inhabited place”
  4. Note the latitude/longitude represented in “degrees minutes direction” (in the example of Ixiamas, La Paz, Bolivia it is Lat: 13 45 S and Long: 068 10 W) and write this information down on a sheet of paper
  5. Visit the Hebcal Custom Calendar latitude/longitude page at http://www.hebcal.com/hebcal/?c=on;geo=pos
  6. Type the latitude and longitude into the form (13 degrees, 45 minutes South Latitude, 68 degrees 10 minutes West Longitude)
  7. Select the Time zone option specific to your location (see Wikipedia’s List of tz database time zones)
  8. Click “Get Calendar” button at the bottom of the form

Posted by & filed under Download - Microsoft Outlook.

Follow these instructions to add a Hebcal Jewish holiday calendar 5-year feed to older versions of Microsoft Outlook.

First, you’ll need to download an Outlook CSV (Comma-separated values) file from hebcal.com:

  1. Open a web browser on your Microsoft Windows computer.
    1. to download holidays and candle-lighting times, navigate to http://www.hebcal.com/hebcal/
    2. OR, to download Yahrzeit + Anniversary calendar, navigate to to http://www.hebcal.com/yahrzeit/
  2. Fill out the form with your preferences and click the Create Calendar button
  3. Click the Download… button
    Jewish_Calendar_2017_Providence___Hebcal_Jewish_Calendar 478px
  4. Select the CSV option from the Download dialog box
    CSV Jewish calendar download dialog box
  5. In the dialog box, select one of the two Download buttons – either Outlook CSV – USA date format (month/day/year) or Outlook CSV – European date format (day/month/year) (depending on whether you want USA or European date formats).
  6. When prompted, specify a convenient name and location for the hebcal_DATE_LOCATION.csv file in the “Save As” dialogue box. We recommend saving the file on the Desktop

Next, import that file into Outlook:

  1. Open Microsoft Outlook
  2. Select the File -> Import and Export… menu option
  3. Select “Import from another program or file” and click Next
  4. Select “Comma Separated Values (Windows)” and click Next
  5. Find the hebcal_DATE_LOCATION.csv file you downloaded and select “Do not import duplicate items” and click Next
  6. Select Calendar and click Next. This will import your chosen file
  7. (optional) Synchronize your Pocket PC or Palm handheld with Outlook

For specific instructions for a particular version of Outlook, please see the “How to Import Text Data” section of one of these articles:

Included in the Hebcal Jewish holiday downloads are options to select major holidays (Rosh Hashana, Yom Kippur, Pesach, etc.), minor holidays (Purim, Chanukah, etc.), special Shabbatot, public fasts (Tish’a B’Av, etc.), Rosh Chodesh, and modern holidays (Yom HaAtzma’ut, etc.).

Posted by & filed under Download - Apple Mac OS X iCal.

Follow these instructions to subscribe to a Hebcal Jewish holiday calendar 5-year feed in Calendar.app on Mac OS X desktop:

  1. Open a web browser on your Mac OS X computer.
    1. to download holidays and candle-lighting times, navigate to http://www.hebcal.com/hebcal/
    2. OR, to download Yahrzeit + Anniversary calendar, navigate to to http://www.hebcal.com/yahrzeit/
  2. Fill out the form with your preferences and click the Create Calendar button
  3. Click the Download… button
    Jewish_Calendar_2017_Providence___Hebcal_Jewish_Calendar 478px
  4. Click on the “Mac OS X” option from the Download dialog box
    Apple Mac OS X Jewish calendar download dialog box
  5. Click on the “Download to Mac Calendar” button
  6. Apple Calendar (OS X Mountain Lion and later) or iCal (OS X Lion and earlier) will start up
  7. Click Subscribe in the “Calendar URL:” dialog box (see screenshot below)
    Enter the url of the calendar you want to subscribe to
  8. In the next dialog box, uncheck the “Remove Alerts” option if you wish to be notified of candle-lighting and Havdalah times.
    Mac OS X Calendar Info dialog box v3
  9. Use Location: iCloud if you wish to synchronize with other Apple devices such as iPhone or iPad. Use Location: On My Mac if you wish to have the calendar subscription only on your desktop.
  10. Click OK

Included in the Hebcal Jewish holiday downloads are options to select major holidays (Rosh Hashana, Yom Kippur, Pesach, etc.), minor holidays (Purim, Chanukah, etc.), special Shabbatot, public fasts (Tish’a B’Av, etc.), Rosh Chodesh, and modern holidays (Yom HaAtzma’ut, etc.).

Posted by & filed under Download - Google Calendar.

Follow these instructions to add a Hebcal Jewish holiday calendar 5-year feed to Google Calendar.

  1. Open a web browser on your computer.
    1. to download holidays and candle-lighting times, navigate to http://www.hebcal.com/hebcal/
    2. OR, to download Yahrzeit + Anniversary calendar, navigate to to http://www.hebcal.com/yahrzeit/
  2. Fill out the form with your preferences and click the Create Calendar button
  3. Click the Download… button
    Jewish_Calendar_2017_Providence___Hebcal_Jewish_Calendar 478px
  4. Select the Google Calendar option from the Download dialog box
    Google Jewish_Calendar download dialog
  5. Click on the “Add to Google Calendar” button that looks like this:
    Add to Google Calendar
  6. When Google Calendar asks “Would you like to add calendar: Jewish Holidays?” click “Yes, add this calendar”

Included in the Hebcal Jewish holiday downloads are options to select major holidays (Rosh Hashana, Yom Kippur, Pesach, etc.), minor holidays (Purim, Chanukah, etc.), special Shabbatot, public fasts (Tish’a B’Av, etc.), Rosh Chodesh, and modern holidays (Yom HaAtzma’ut, etc.).