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:

  • v=1 – version. Required.
  • cfg=json – output JSON instead of HTML. Also variant cfg=fc for fullcalendar.io integration
  • 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
  • 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

Mutually exclusive options for Diaspora/Israel holidays and Torah Readings:

  • i=off – Diaspora holidays and Torah readings (default if unspecified)
  • i=on – Israel holidays and Torah readings

Mutually exclusive location for candle-lighting times:

  • geo=none – no candle-lighting location (default if unspecified)
  • 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)

Mutually exclusive language parameter:

  • lg=s – Sephardic transliterations (default if unspecified)
  • lg=sh – Sephardic translit. + Hebrew
  • lg=a – Ashkenazis transliterations
  • lg=ah – Ashkenazis translit. + Hebrew
  • lg=h – Hebrew only

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:

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

Posted by & filed under Download - BlackBerry.

We’re pleased to offer Jewish holiday downloads for BlackBerry devices through a two step process that sends Hebcal data first to Google Calendar, and then to your BlackBerry.

Note that Hebcal is not an app for BlackBerry (in the BlackBerry App World sense of apps that you install). Rather, Hebcal is a website that allows you to download/export calendar data to the calendar application that comes natively with your device.

1. Follow our Google Calendar Jewish holidays download instructions.

2. Then, follow these instructions depending on whether you use the Google Apps for Work (enterprise) + BB10 or regular Google + BB5, BB6 or BB7:

Google Apps for Work users use Google Sync for BlackBerry, which uses ActiveSync to sync with Google Apps. See Set Up Google Sync for BlackBerry 10 for more details.

Non-enterprise Google users with BlackBerry 5, 6, or 7 can use BlackBerry® Internet Service (BIS), which is part of the standard BlackBerry service plan to sync Gmail, Google Calendar, and Contacts with their BlackBerry. BIS is provided by RIM and mobile carriers. BlackBerry offers this guidance on syncing Calendar. Please contact RIM or your carrier for more information and support.

Posted by & filed under Download - Microsoft Outlook.

Follow these instructions to add a Hebcal Jewish holiday calendar 5-year feed to Outlook.com (previously called Windows Live Calendar).

  1. Go to http://www.hebcal.com/hebcal/ if you’re downloading a holiday calendar, or http://www.hebcal.com/yahrzeit/ if you’re downloading a Yahrzeit + Anniversary calendar.
  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.com option from the Download dialog box, and click on Download to Outlook.com Calendar button.
    Hebcal download dialog Outlook Windows Live Calendar
  5. When you get to the Outlook.com page, select a calendar color and an optional Charm, then click Subscribe:
    Outlook Windows Live Calendar_-_Import_or_Subscribe v2

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 General.

Feel free to make printed calendars, email newsletters, refrigerator magnets, and other content using events from Hebcal.com.

Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution 3.0 License.

Among other things, this license gives you permission to remix, transform, and build upon the material for any purpose, even commercially. You must give appropriate credit to Hebcal.com, but beyond that you need not send us money or even explicitly ask us for permission.

cc_by_logo

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

Follow these steps to remove Hebcal events from your Mac Desktop calendar or iCloud calendar and you didn’t use the Subscription feature.

(If you subscribed to a Hebcal in Apple iCal on Mac OS X, follow our delete/unsubscribe from Mac Calendar (iCal) instructions.)

1. Open Mac Calendar, and uncheck all calendars except for the one that contains Hebcal events.

 

Mac_Calendar_delete_Hebcal_step_1

2. In the search box on the upper-right, type the text “hebcal” and press Return to select Events that contain “hebcal”

Mac_Calendar_delete_Hebcal_step_2

3. Click on the first item in the search results pane on the right. Scroll to the bottom, and holding down the Shift key, click on the last item in the search results pane on the right

Mac_Calendar_delete_Hebcal_step_3

4. Press the Delete key, or use the Edit Delete menu to remove the events.

We’ve tested these instructions on Mac OS X 10.9 Mavericks and Mac OS X 10.10.2 Yosemite.