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. For best performance, be sure to use cache: true.

Here’s the FullCalendar invocation:

$(document).ready(function() {
    $("#calendar").fullCalendar({
        header: {
            left: "prev,next today",
            center: "title",
            right: "month,agendaWeek,agendaDay"
        },
        editable: false,
        fixedWeekCount: false,
        timezone: false,
        events: {
            url: "http://www.hebcal.com/hebcal/?cfg=fc&v=1&i=off&maj=on&min=on&nx=on&mf=on&ss=on&mod=on&lg=s&s=on",
            cache: true
        }
    });
    $("body").keydown(function(e) {
        if (e.keyCode == 37) {
            $('#calendar').fullCalendar('prev');
        } else if (e.keyCode == 39) {
            $('#calendar').fullCalendar('next');
        }
    });
});

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

.fc-event.hebdate, .fc-event.omer {
 background-color:#FFF;
 border-color:#FFF;
 color:#999;
}
.fc-event.dafyomi {
 background-color:#FFF;
 border-color:#FFF;
 color:#08c;
}
.fc-event.dafyomi a {
 color: #0088cc;
}
.fc-event.dafyomi a:hover,
.fc-event.dafyomi a:focus {
 color: #005580;
}
.fc-event.candles, .fc-event.havdalah {
 background-color:#FFF;
 border-color:#FFF;
 color:#333;
}
.fc-event.holiday {
 background-color:#3a87ad;
 border-color:#3a87ad;
 color:#FFF;
}
.fc-event.holiday.yomtov {
 background-color:#ffd446;
 border-color:#ffd446;
 color:#333;
}
.fc-event.parashat {
 background-color:#257e4a;
 border-color:#257e4a;
 color:#FFF;
}
.fc-event.hebrew .fc-title {
 font-family:'Alef Hebrew','SBL Hebrew',David;
 font-size:110%;
 font-weight:normal;
 direction:rtl;
}
.fc-event.hebrew .fc-time {
 direction:ltr;
 unicode-bidi: bidi-override;
}

Here’s a complete example:

<!DOCTYPE html>
<html><head>
<title>Jewish Calendar</title>
<link href="//cdnjs.cloudflare.com/ajax/libs/fullcalendar/2.2.6/fullcalendar.min.css" rel="stylesheet">
<script src="//cdnjs.cloudflare.com/ajax/libs/moment.js/2.9.0/moment.min.js"></script>
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
<script src="//cdnjs.cloudflare.com/ajax/libs/fullcalendar/2.2.6/fullcalendar.min.js"></script>
<style type="text/css">
.fc-event.hebdate, .fc-event.omer {
 background-color:#FFF;
 border-color:#FFF;
 color:#999;
}
.fc-event.dafyomi {
 background-color:#FFF;
 border-color:#FFF;
 color:#08c;
}
.fc-event.dafyomi a {
 color: #0088cc;
}
.fc-event.dafyomi a:hover,
.fc-event.dafyomi a:focus {
 color: #005580;
}
.fc-event.candles, .fc-event.havdalah {
 background-color:#FFF;
 border-color:#FFF;
 color:#333;
}
.fc-event.holiday {
 background-color:#3a87ad;
 border-color:#3a87ad;
 color:#FFF;
}
.fc-event.holiday.yomtov {
 background-color:#ffd446;
 border-color:#ffd446;
 color:#333;
}
.fc-event.parashat {
 background-color:#257e4a;
 border-color:#257e4a;
 color:#FFF;
}
.fc-event.hebrew .fc-title {
 font-family:'Alef Hebrew','SBL Hebrew',David;
 font-size:110%;
 font-weight:normal;
 direction:rtl;
}
.fc-event.hebrew .fc-time {
 direction:ltr;
 unicode-bidi: bidi-override;
}
</style>
</head>
<body>

<div id="calendar"></div>

<script>
$(document).ready(function() {
    $("#calendar").fullCalendar({
        header: {
            left: "prev,next today",
            center: "title",
            right: "month,agendaWeek,agendaDay"
        },
        editable: false,
        fixedWeekCount: false,
        timezone: false,
        events: {
            url: "http://www.hebcal.com/hebcal/?cfg=fc&v=1&i=off&maj=on&min=on&nx=on&mf=on&ss=on&mod=on&lg=s&s=on",
            cache: true
        }
    });
    $("body").keydown(function(e) {
        if (e.keyCode == 37) {
            $('#calendar').fullCalendar('prev');
        } else if (e.keyCode == 39) {
            $('#calendar').fullCalendar('next');
        }
    });
});
</script>
</body></html>

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 newer versions of Microsoft Outlook.

This technique uses Outlook’s “Internet Calendar Subscription” feature which keeps a separate calendar from your primary calendar. The calendar appears as an “overlay” and can be managed separately from your main calendar.

This method is preferred for newer versions, e.g. Outlook 2010, Outlook 2010, Outlook 2013, Office 365. If you plan to sync Outlook with a BlackBerry, consider using the old-style Outlook CSV instructions instead.

  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_2014_Providence___Hebcal_Jewish_Calendar
  4. Select the Outlook option from the Download dialog box
    Outlook Jewish calendar download dialog box v2
  5. Click on the Download Outlook Internet Calendar Subscription button
  6. You might be prompted to acknowledge that you are opening a hyperlink. You should click Yes.
  7. Microsoft Office Outlook 2007, 2010, or 2013 will start up
  8. At the prompt, Add this Internet Calendar to Outlook and subscribe to updates, click Yes.
  9. The Internet Calendar opens in side-by-side view in the Outlook Calendar and is added to the Navigation Pane in Calendar view under Other Calendars. The calendar will check periodically for any updates made by the calendar publisher.

For more details, see Add an Internet Calendar Subscription to Outlook from Microsoft’s support site.

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 - 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_2014_Providence___Hebcal_Jewish_Calendar
  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_2014_Providence___Hebcal_Jewish_Calendar
  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_2014_Providence___Hebcal_Jewish_Calendar
  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.).

Posted by & filed under Download - Microsoft Outlook.

Follow these instructions to subscribe to a Hebcal Jewish holiday calendar 5-year feed in Microsoft Outlook 2011 for Mac OS X:

  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
  4. Select the Outlook 2011 (Mac OS X) option from the Download dialog box
  5. Click on the Jewish Calendar YYYY.ics download button
Jewish_Calendar_2014_Providence___Hebcal_Jewish_Calendar

Next, find the downloaded .ics file (typically in your Downloads or Desktop folder). To get the Jewish holidays to show up with a color-coded category, be sure to drag and drop the .ics file you downloaded onto one of the category labels on the left pane as follows:

Screen shot of adding a hebcal.ics file to Outlook 2011 for Mac OS X

If you simply drag the .ics file to Outlook 2011 icon in your dock or double-click on it, it will get categorized and color-coded as “No Category” which is probably not what you want.

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 - iPhone, iPad, iOS.

Follow these instructions to subscribe to a Hebcal Jewish Calendar 5-year feed directly from your iPhone or iPad (running iOS 3.0 or higher):

  1. Open Safari on your iPhone or iPad
    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
    ios7 download step 1
  4. Select the iPhone & iPad (iOS 3.0 and higher) option from the Download dialog box
    ios7 download step 2
  5. Click on the Jewish Calendar YYYY.ics download button
  6. When the Subscribe to the calendar “Hebcal YEAR”? dialog box appears, click Subscribe
    ios7 download step 3
  7. When iPhone has finished subscribing, click Done
  8. If you later wish to remove it from your phone, go to over to Settings > Mail, Contacts, Calendar. You will see all your subscriptions listed under Accounts. Choose the one you want to edit or remove, and hit Delete Account

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, Download - removal.

Follow these instructions if you no longer wish to subscribe to Hebcal in Apple iCal on your desktop (also called Calendar.app on more recent versions of Mac OS X).

(If you inadvertently merged the Hebcal calendar events with your personal calendar and you didn’t use the Subscription feature, use our delete Hebcal merged events instructions instead.)

Deleting a calendar subscription is easy, and it removes the entire calendar and all the events it contains from your computer.

  1. Select the Hebcal calendar you want to delete in the calendar list on the left side of iCal.
  2. Choose Edit > Delete.

Here’s an example screenshot:

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

Hebcal.com offers a REST API for fetching Jewish calendar data. The output format is in JSON.

The basic URL format is as follows:

http://www.hebcal.com/hebcal/?v=1&cfg=json&maj=on&min=on&mod=on&nx=on&year=now&month=x&ss=on&mf=on&c=on&geo=geoname&geonameid=3448439&m=50&s=on

Note the following customizable parameters and their meanings:

  • year=now – “now” for current year, or 4-digit YYYY such as 2003
  • month=x – “x” for entire Gregorian year, or use a numeric month (1=January, 6=June, etc.)
  • maj=on – Major holidays
  • min=on – Minor holidays (Tu BiShvat, Lag B’Omer, …)
  • nx=on – Rosh Chodesh
  • mf=on – Minor fasts (Ta’anit Esther, Tzom Gedaliah, …)
  • ss=on – Special Shabbatot (Shabbat Shekalim, Zachor, …)
  • mod=on – Modern holidays (Yom HaShoah, Yom HaAtzma’ut, …)
  • s=on – Parashat ha-Shavuah on Saturday
    • i=off – Diaspora sedra scheme
    • i=on – Israel sedra scheme
  • c=on – Candle lighting times. See also candle-lighting options below.
    • m=50 – Havdalah 50 minutes after sundown. Set to m=0 (zero) to disable Havdalah times
    • b=18 – Candle-lighting time minutes before sunset
  • D=on – Hebrew date for dates with some event
  • d=on – Hebrew date for entire date range
  • o=on – Days of the Omer

Note mutually exclusive location for candle-lighting times:

  • geo=none – no candle-lighting location (default)
  • geo=geoname – location specified by GeoNames.org numeric ID
    • requires additional parameter geonameid=3448439
    • Hebcal.com supports approximately 47,000 different GeoNames IDs. These are cities with a population of 5000+. See cities5000.zip from http://download.geonames.org/export/dump/.
  • geo=zip – location specified by United States ZIP code
    • requires additional parameter zip=90210
  • geo=city – location specified by one of the Hebcal.com legacy city identifiers
    • requires additional parameter city=GB-London
  • geo=pos – location specified by latitude, longitude, and timezone. Requires additional 7 parameters:
    • ladeg=[0-90] – latitude degrees
    • lamin=[0-60] – latitude minutes
    • ladir={n,s} – latitude direction (North or South)
    • lodeg=[0-180] – longitude degrees
    • lomin=[0-60] -longitude minutes
    • lodir={e,w} -longitude direction (East or West)
    • tzid=TimezoneIdentifier (See List of tz database time zones)

Note mutually exclusive language parameter:

  • lg=s – Sephardic transliterations
  • lg=sh – Sephardic translit. + Hebrew
  • lg=a – Ashkenazis transliterations
  • lg=ah – Ashkenazis translit. + Hebrew
  • lg=h – Hebrew only

Note also an optional callback parameter:

  • callback=function – wraps the JSON output text in parentheses and a function name of your choosing. Callback function names may only use upper and lowercase alphabetic characters (A-Z, a-z), numbers (0-9), the period (.), the underscore (_).

And example output looks like this:

{
    "link": "http://www.hebcal.com/hebcal/?v=1;nx=on;year=2015;month=5;ss=on;mf=on;c=on;geo=geoname;geonameid=3448439;m=50;s=on;maj=on;min=on;mod=on",
    "latitude": -23.5475,
    "longitude": -46.63611,
    "title": "Hebcal May 2015 São Paulo, Brazil",
    "date": "2014-11-30T06:53:48-00:00",
    "location": {
        "geonameid": 3448439,
        "latitude": -23.5475,
        "tzid": "America/Sao_Paulo",
        "geo": "geoname",
        "title": "São Paulo, Brazil",
        "city": "São Paulo",
        "longitude": -46.63611
    },
    "items": [{
        "category": "candles",
        "title": "Candle lighting: 5:11pm",
        "date": "2015-05-22T17:11:00-03:00"
    }, {
        "date": "2015-05-23",
        "hebrew": "פרשת במדבר",
        "title": "Parashat Bamidbar",
        "link": "http://www.hebcal.com/sedrot/bamidbar",
        "category": "parashat",
        "leyning": {
            "torah":"Numbers 1:1 - 4:20",
            "haftarah":"Hosea 2:1 - 2:22"
        }
    }, {
        "category": "holiday",
        "link": "http://www.hebcal.com/holidays/shavuot",
        "hebrew": "ערב שבועות",
        "date": "2015-05-23",
        "title": "Erev Shavuot"
    }, {
        "date": "2015-05-23T18:19:00-03:00",
        "title": "Candle lighting: 6:19pm",
        "category": "candles"
    }, {
        "link": "http://www.hebcal.com/holidays/shavuot",
        "hebrew": "שבועות יום א׳",
        "date": "2015-05-24",
        "title": "Shavuot I",
        "yomtov": true,
        "category": "holiday"
    }, {
        "category": "holiday",
        "yomtov": true,
        "title": "Shavuot II",
        "hebrew": "שבועות יום ב׳",
        "date": "2015-05-25",
        "link": "http://www.hebcal.com/holidays/shavuot"
    }, {
        "category": "havdalah",
        "title": "Havdalah (50 min): 6:18pm",
        "date": "2015-05-25T18:18:00-03:00"
    }]
}

If you don’t want candle lighting times, just use c=off and omit the zip and m parameters.