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

We offer a simple API for converting between Gregorian and Hebrew dates. Two output formats are supported: JSON and XML.

To convert from Gregorian to Hebrew date use this URL format:

http://www.hebcal.com/converter/?cfg=json&gy=2011&gm=6&gd=2&g2h=1

  • gy=2011 – Gregorian year
  • gm=6 – Gregorian month (1=January, 12=December)
  • gd=2 – Gregorian day of month
  • g2h=1 – Convert from Gregorian to Hebrew date
  • gs=on – After sunset on Gregorian date
  • cfg=json – output format is JSON (cfg=json) or XML (cfg=xml)

To convert from Hebrew to Gregorian use this URL format:

http://www.hebcal.com/converter/?cfg=json&hy=5749&hm=Kislev&hd=25&h2g=1

  • hy=5749 – Hebrew year
  • hm=Kislev – Hebrew month (Nisan, Iyyar, Sivan, Tamuz, Av, Elul, Tishrei, Cheshvan, Kislev, Tevet, Shvat, Adar1, Adar2)
  • hd=25 – Hebrew day of month
  • h2g=1 – Convert from Hebrew to Gregorian date
  • cfg=json – output format is JSON (cfg=json) or XML (cfg=xml)

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 (_).

Sample output in JSON and XML:

Posted by & filed under Download - General.

Many calendar desktop, mobile or web apps support the iCalendar (.ICS file extension) format. Hebcal has specific instructions for the major calendar apps in that consume iCalendar files (see below).

iCalendar is an open standard for exchanging calendar information. It is also known as RFC 2445.

For minor calendar apps, Hebcal recommends the following:

  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 2011 (Mac OS X) option from the Download dialog box
  5. Click on the Jewish Calendar YYYY-YYYY.ics download button
  6. Import the Jewish Calendar YYYY-YYYY.ics file into your app

Specific instructions for the major calendar apps which use iCalendar format:

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.

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

Note that Hebcal is not an app for Android (in the Google Play 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. Go back to your Android device and enable synchronization to Google Calendar. Here are “Sync & display calendars” instructions for specific versions of Android:

Note that there appears to be a limitation in Android calendar where events more than one year in the future will not sync to your device. The events are visible on the Google Calendar on the Web but will not download to the device until the current date approaches more closely.

See these articles for more detail:

How do I sync Google Calendar events that occur more than one year in the future?

Android Bug #41281