Posted by & filed under News, Observance.

Ta’anit Bechorot (Fast of the Firstborn) falls on Friday, April 6, 2012. An earlier version of the calendar we publish incorrectly had this minor fast on Thursday.

When this fast day falls on Friday, we do in fact observe the fast on Friday, even though Shabbat follows immediately.

It is only in years when the date of the fast falls on Shabbat that the fast is moved. In this case, Ta’anit Bechorot is moved back to Thursday, because it is preferable not to fast immediately before Shabbat.

Source: Mishnah Berurah: the classic commentary to Shulchan Aruch Orach Chayim, comprising the laws of daily Jewish conduct, Volume V (B), Pesach. §470: “That the first-born fast on Erev Pesach.”

Posted by & filed under News.

Hebcal.com got hit with a script injection virus this week but everything is fine now.

We had a stale copy of the WordPress content management system for our Help and News pages, so some malicious person/machine exploited a loophole. We have upgraded to the latest copy and have removed all traces of the virus from our website.

Our sincere apologies for any inconvenience we may have caused.

Posted by & filed under Download - iPhone, iPad, iOS, Download - removal.

To remove a Hebcal calendar from your iPhone or iPad, you’ll need to first determine if you subscribed via iCloud or whether you subscribed directly from your iOS device.

Subscribed via iCloud

  1. Log into iCloud in a web browser.
  2. Go to the iCloud Calendar.
  3. Click Edit in the sidebar.
  4. Click the Delete button  to the right of the calendar’s name.
  5. Click Delete Calendar.

Source: iCloud: Delete a calendar

Subscribed directly from iOS device

To remove a Hebcal calendar from your iPhone or iPad, first go to the Settings app, then touch Mail, Contacts, Calendars. Scroll down until you see the Subscribed Calendars item:

 

Touch Subscribed Calendars to see the list:

 

Then, touch the Hebcal calendar to delete:

 

Touch the red Delete Account button, then touch Delete Account again to confirm.

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:

{"gy":2011,"gm":6,"gd":2,
"hy":5771,"hm":"Iyyar","hd":29,
"hebrew":"כ״ט בְּאִיָיר תשע״א"
}

Sample output in XML:

<?xml version="1.0" ?>
<hebcal>
<gregorian year="2011" month="6" day="2" />
<hebrew year="5771" month="Iyyar" day="29" str="כ״ט בְּאִיָיר תשע״א" />
</hebcal>

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

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:

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 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&nh=on&nx=on&year=now&month=x&ss=on&mf=on&c=on&zip=90210&m=72&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.)
  • nh=on – Major holidays
  • nx=on – Rosh Chodesh
  • mf=on – Minor fasts
  • ss=on – Special Shabbatot
  • s=on – Parashat ha-Shavuah on Saturday
    • i=off – Diaspora sedra scheme
    • i=on – Israel sedra scheme
  • c=on – Candle lighting times
    • zip=90210 – use zip code 90210 for candle lighting times
    • m=72 – Havdalah 72 minutes after sundown. Set to m=0 (zero) to disable Havdalah times
  • 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 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:

{
   "title":"Hebcal 2013 Beverly Hills, CA 90210",
   "link":"http://www.hebcal.com/hebcal/?v=1;nh=on;nx=on;year=2013;month=x;ss=on;mf=on;c=on;zip=90210;m=72;s=on;geo=zip;tz=-8;dst=usa",
   "date":"2013-05-24T16:13:20-00:00",
   "latitude":34.0925,
   "longitude":-118.4099,
   "items":[
      {
         "title":"Candle lighting: 4:39pm",
         "category":"candles",
         "date":"2013-01-04T16:39:00-08:00"
      },
      {
         "title":"Parashat Shemot",
         "category":"parashat",
         "date":"2013-01-05",
         "link":"http://www.hebcal.com/sedrot/shemot",
         "hebrew":"פרשת שמות"
      },
      {
         "title":"Havdalah (72 min): 6:10pm",
         "category":"havdalah",
         "date":"2013-01-05T18:10:00-08:00"
      },
      {
         "title":"Tu BiShvat",
         "category":"holiday",
         "date":"2013-01-26",
         "link":"http://www.hebcal.com/holidays/tu-bishvat",
         "hebrew":"טו בשבט"
      }
   ]
}

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