1 files changed, 188 insertions, 0 deletions
diff --git a/comm/calendar/test/unit/test_rfc3339_parser.js b/comm/calendar/test/unit/test_rfc3339_parser.js
new file mode 100644
index 0000000000..8098bdddf6
--- /dev/null
+++ b/comm/calendar/test/unit/test_rfc3339_parser.js
@@ -0,0 +1,188 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+function run_test() {
+  do_calendar_startup(really_run_test);
+}
+
+function really_run_test() {
+  // Check if the RFC 3339 date and timezone are properly parsed to the
+  // expected result and if the result is properly mapped back into the RFC
+  // 3339 date.
+  function testRfc3339(
+    aRfc3339Date,
+    aTimezone,
+    aExpectedDateTime,
+    aExpectedRfc3339Date = aRfc3339Date
+  ) {
+    // Test creating a dateTime object from an RFC 3339 string.
+    let dateTime = cal.dtz.fromRFC3339(aRfc3339Date, aTimezone);
+
+    // Check that each property is as expected.
+    let expectedDateProps = {
+      year: aExpectedDateTime[0],
+      month: aExpectedDateTime[1] - 1, // 0 based month.
+      day: aExpectedDateTime[2],
+      hour: aExpectedDateTime[3],
+      minute: aExpectedDateTime[4],
+      second: aExpectedDateTime[5],
+      timezone: aExpectedDateTime[6],
+      isDate: aExpectedDateTime[7],
+    };
+    for (let prop in expectedDateProps) {
+      info("Checking prop: " + prop);
+      // Object comparison fails with ical.js, and we only want to check
+      // that we have the right timezone.
+      if (prop == "timezone") {
+        equal(dateTime[prop].tzid, expectedDateProps[prop].tzid);
+      } else {
+        equal(dateTime[prop], expectedDateProps[prop]);
+      }
+    }
+
+    // Test round tripping that dateTime object back to an RFC 3339 string.
+    let rfc3339Date = cal.dtz.toRFC3339(dateTime);
+
+    // In theory this should just match the input RFC 3339 date, but there are
+    // multiple ways of generating the same time, e.g. 2006-03-14Z is
+    // equivalent to 2006-03-14.
+    equal(rfc3339Date, aExpectedRfc3339Date);
+  }
+
+  /*
+   * Some notes about the differences between calIDateTime and the RFC 3339
+   * specification:
+   * 1. calIDateTime does not support fractions of a second, they are
+   *    stripped.
+   * 2. If a timezone cannot be matched to the given time offset, the
+   *    date/time is returned as a UTC date/time.
+   * 3. The first timezone (alphabetically) that has the same offset is
+   *    chosen.
+   * 4. Leap seconds are not supported by calIDateTime, it resets to
+   *    [0-23]:[0-59]:[0-59].
+   *
+   * All tests are done under the default timezone and UTC (although both
+   * should give the same time).
+   */
+
+  // An arbitrary timezone (that has daylight savings time).
+  let getTz = aTz => cal.timezoneService.getTimezone(aTz);
+  let timezone = getTz("America/New_York");
+  let utc = cal.dtz.UTC;
+
+  // Timezones used in tests. This isn't a great representation, as we don't
+  // care what the actual timezone is, just that the offset is correct. Offset
+  // isn't presently easily accessible from the timezone object, however.
+  let utcminus6 = getTz("America/Bahia_Banderas");
+  let dawson = getTz("America/Dawson");
+
+  /*
+   * Basic tests
+   */
+  // This represents March 14, 2006 in the default timezone.
+  testRfc3339("2006-03-14", timezone, [2006, 3, 14, 0, 0, 0, timezone, true]);
+  testRfc3339("2006-03-14", utc, [2006, 3, 14, 0, 0, 0, utc, true]);
+  // This represents March 14, 2006 in UTC.
+  testRfc3339("2006-03-14Z", timezone, [2006, 3, 14, 0, 0, 0, utc, true], "2006-03-14");
+  testRfc3339("2006-03-14Z", utc, [2006, 3, 14, 0, 0, 0, utc, true], "2006-03-14");
+
+  // This represents 30 minutes and 53 seconds past the 13th hour of November
+  // 14, 2050 in UTC.
+  testRfc3339(
+    "2050-11-14t13:30:53z",
+    timezone,
+    [2050, 11, 14, 13, 30, 53, utc, false],
+    "2050-11-14T13:30:53Z"
+  );
+  testRfc3339(
+    "2050-11-14t13:30:53z",
+    utc,
+    [2050, 11, 14, 13, 30, 53, utc, false],
+    "2050-11-14T13:30:53Z"
+  );
+
+  // This represents 03:00:23 on October 14, 2004 in Central Standard Time.
+  testRfc3339("2004-10-14T03:00:23-06:00", timezone, [2004, 10, 14, 3, 0, 23, utcminus6, false]);
+  testRfc3339("2004-10-14T03:00:23-06:00", utc, [2004, 10, 14, 3, 0, 23, utcminus6, false]);
+
+  /*
+   * The following tests are the RFC 3339 examples
+   * http://tools.ietf.org/html/rfc3339
+   * Most of these would "fail" since iCalDateTime does not supported
+   * all parts of the specification, the true proper response is next to each
+   * test line as a comment.
+   */
+
+  // This represents 20 minutes and 50.52 seconds after the 23rd hour of
+  // April 12th, 1985 in UTC.
+  testRfc3339(
+    "1985-04-12T23:20:50.52Z",
+    timezone,
+    [1985, 4, 12, 23, 20, 50, utc, false],
+    "1985-04-12T23:20:50Z"
+  ); // 1985/04/12 23:20:50.52 UTC isDate=0
+  testRfc3339(
+    "1985-04-12T23:20:50.52Z",
+    utc,
+    [1985, 4, 12, 23, 20, 50, utc, false],
+    "1985-04-12T23:20:50Z"
+  ); // 1985/04/12 23:20:50.52 UTC isDate=0
+
+  // This represents 39 minutes and 57 seconds after the 16th hour of December
+  // 19th, 1996 with an offset of -08:00 from UTC (Pacific Standard Time).
+  // Note that this is equivalent to in UTC.
+  testRfc3339("1996-12-19T16:39:57-08:00", timezone, [1996, 12, 19, 16, 39, 57, dawson, false]);
+  testRfc3339("1996-12-19T16:39:57-08:00", utc, [1996, 12, 19, 16, 39, 57, dawson, false]);
+  testRfc3339("1996-12-20T00:39:57Z", timezone, [1996, 12, 20, 0, 39, 57, utc, false]);
+  testRfc3339("1996-12-20T00:39:57Z", utc, [1996, 12, 20, 0, 39, 57, utc, false]);
+
+  // This represents the same instant of time as noon, January 1, 1937,
+  // Netherlands time. Standard time in the Netherlands was exactly 19 minutes
+  // and 32.13 seconds ahead of UTC by law from 1909-05-01 through 1937-06-30.
+  // This time zone cannot be represented exactly using the HH:MM format, and
+  // this timestamp uses the closest representable UTC offset.
+  //
+  // Since no current timezone exists at +00:20 it will default to giving the
+  // time in UTC.
+  testRfc3339(
+    "1937-01-01T12:00:27.87+00:20",
+    timezone,
+    [1937, 1, 1, 12, 20, 27, utc, false],
+    "1937-01-01T12:20:27Z"
+  ); // 1937/01/01 12:20:27.87 UTC isDate=0
+  testRfc3339(
+    "1937-01-01T12:00:27.87+00:20",
+    utc,
+    [1937, 1, 1, 12, 20, 27, utc, false],
+    "1937-01-01T12:20:27Z"
+  ); // 1937/01/01 12:20:27.87 UTC isDate=0
+
+  // This represents the leap second inserted at the end of 1990.
+  testRfc3339(
+    "1990-12-31T23:59:60Z",
+    timezone,
+    [1991, 1, 1, 0, 0, 0, utc, false],
+    "1991-01-01T00:00:00Z"
+  ); // 1990/12/31 23:59:60 UTC isDate=0
+  testRfc3339(
+    "1990-12-31T23:59:60Z",
+    utc,
+    [1991, 1, 1, 0, 0, 0, utc, false],
+    "1991-01-01T00:00:00Z"
+  ); // 1990/12/31 23:59:60 UTC isDate=0
+  // This represents the same leap second in Pacific Standard Time, 8
+  // hours behind UTC.
+  testRfc3339(
+    "1990-12-31T15:59:60-08:00",
+    timezone,
+    [1990, 12, 31, 16, 0, 0, dawson, false],
+    "1990-12-31T16:00:00-08:00"
+  ); // 1990/12/31 15:59:60 America/Dawson isDate=0
+  testRfc3339(
+    "1990-12-31T15:59:60-08:00",
+    utc,
+    [1990, 12, 31, 16, 0, 0, dawson, false],
+    "1990-12-31T16:00:00-08:00"
+  ); // 1990/12/31 15:59:60 America/Dawson isDate=0
+}