Merge "Document our potentially suprising behavior on date ranges ending at midnight."

     * instead of using the name of the month.  For example, "12/31/2008"

     * instead of "December 31, 2008".

     *

     * <p>

     * If the end date ends at 12:00am at the beginning of a day, it is

     * formatted as the end of the previous day in two scenarios:

     * <ul>

     *   <li>For single day events. This results in "8pm - midnight" instead of

     *       "Nov 10, 8pm - Nov 11, 12am".</li>

     *   <li>When the time is not displayed. This results in "Nov 10 - 11" for

     *       an event with a start date of Nov 10 and an end date of Nov 12 at

     *       00:00.</li>

     * </ul>

     *

     * @param context the context is required only if the time is shown

     * @param formatter the Formatter used for formatting the date range.

     * Note: be sure to call setLength(0) on StringBuilder passed to

            dayDistance = endJulianDay - startJulianDay;

        }

        // If the end date ends at 12am at the beginning of a day,

        // then modify it to make it look like it ends at midnight on

        // the previous day.  This will allow us to display "8pm - midnight",

        // for example, instead of "Nov 10, 8pm - Nov 11, 12am". But we only do

        // this if it is midnight of the same day as the start date because

        // for multiple-day events, an end time of "midnight on Nov 11" is

        // ambiguous and confusing (is that midnight the start of Nov 11, or

        // the end of Nov 11?).

        // If we are not showing the time then also adjust the end date

        // for multiple-day events.  This is to allow us to display, for

        // example, "Nov 10 -11" for an event with a start date of Nov 10

        // and an end date of Nov 12 at 00:00.

        // If the start and end time are the same, then skip this and don't

        // adjust the date.

        if (!isInstant

            && (endDate.hour | endDate.minute | endDate.second) == 0

            && (!showTime || dayDistance <= 1)) {