feat(time): parse ISO 8601 Z timestamps

Author: ClaudiuCeia

src/Time.ts

@@ -74,6 +74,24 @@ export const time = (
 };
 
 export const Time = createLanguageThis({
+  ISODateTimeZ() {
+    // Example: 2004-07-12T22:18:09Z
+    // Keep it strict and UTC-only for now.
+    return map(
+      regex(
+        /\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z/i,
+        "iso-datetime-z",
+      ),
+      (raw, b, a) => {
+        const d = new Date(raw);
+        if (Number.isNaN(d.getTime())) {
+          // Should be unreachable given the regex, but keep it defensive.
+          return time({ when: raw, grain: "second" }, b, a);
+        }
+        return time({ when: d.toISOString(), grain: "second" }, b, a);
+      },
+    );
+  },
   Grain() {
     return any(
       regex(/sec(ond)?s?/i, "second"),
@@ -502,6 +520,7 @@ export const Time = createLanguageThis({
   parser() {
     return dot(
       any(
+        this.ISODateTimeZ,
         this.FullDateEra,
         this.FullDate,
         this.Relative,

tests/Time.test.ts

@@ -76,6 +76,30 @@ Deno.test("Common", () => {
   }
 });
 
+Deno.test("ISODateTimeZ", () => {
+  const res = Duckling([Time.parser]).extract({
+    text: `Timestamp: 2004-07-12T22:18:09Z.`,
+    index: 0,
+  });
+
+  assertEquals(res.success, true);
+  if (res.success) {
+    assertEquals(res.value, [
+      {
+        end: 31,
+        kind: "time",
+        start: 11,
+        text: "2004-07-12T22:18:09Z",
+        value: {
+          era: "CE",
+          grain: "second",
+          when: "2004-07-12T22:18:09.000Z",
+        },
+      },
+    ]);
+  }
+});
+
 Deno.test("GrainQuantity", () => {
   const res = Duckling([Time.parser]).extract({
     text: `I'll get to it in 5 days, it only takes about 51615 seconds.`,