LibJS: Implement Temporal.*.prototype.toZonedDateTimeISO and friends

Author: https://github.com/trflynn89
Commit: c0150acc5e
Pull-request: https://github.com/LadybirdBrowser/ladybird/pull/2577
Reviewed-by: https://github.com/shannonbooth ✅

Libraries/LibJS/Tests/builtins/Temporal/Instant/Instant.prototype.toZonedDateTimeISO.js

@@ -0,0 +1,36 @@
+describe("correct behavior", () => {
+    test("length is 1", () => {
+        expect(Temporal.Instant.prototype.toZonedDateTimeISO).toHaveLength(1);
+    });
+
+    test("basic functionality", () => {
+        const instant = new Temporal.Instant(1625614921123456789n);
+        const zonedDateTime = instant.toZonedDateTimeISO("UTC");
+        expect(zonedDateTime.year).toBe(2021);
+        expect(zonedDateTime.month).toBe(7);
+        expect(zonedDateTime.day).toBe(6);
+        expect(zonedDateTime.hour).toBe(23);
+        expect(zonedDateTime.minute).toBe(42);
+        expect(zonedDateTime.second).toBe(1);
+        expect(zonedDateTime.millisecond).toBe(123);
+        expect(zonedDateTime.microsecond).toBe(456);
+        expect(zonedDateTime.nanosecond).toBe(789);
+        expect(zonedDateTime.calendarId).toBe("iso8601");
+        expect(zonedDateTime.timeZoneId).toBe("UTC");
+    });
+
+    test("custom time zone object", () => {
+        const timeZone = "UTC";
+        const instant = new Temporal.Instant(1625614921123456789n);
+        const zonedDateTime = instant.toZonedDateTimeISO(timeZone);
+        expect(zonedDateTime.timeZoneId).toBe(timeZone);
+    });
+});
+
+describe("errors", () => {
+    test("this value must be a Temporal.Instant object", () => {
+        expect(() => {
+            Temporal.Instant.prototype.toZonedDateTimeISO.call("foo");
+        }).toThrowWithMessage(TypeError, "Not an object of type Temporal.Instant");
+    });
+});

Libraries/LibJS/Tests/builtins/Temporal/Now/Now.zonedDateTimeISO.js

@@ -0,0 +1,19 @@
+describe("correct behavior", () => {
+    test("length is 0", () => {
+        expect(Temporal.Now.zonedDateTimeISO).toHaveLength(0);
+    });
+
+    test("basic functionality", () => {
+        const zonedDateTime = Temporal.Now.zonedDateTimeISO();
+        expect(zonedDateTime).toBeInstanceOf(Temporal.ZonedDateTime);
+        expect(zonedDateTime.calendarId).toBe("iso8601");
+    });
+
+    test("with time zone", () => {
+        const timeZone = "UTC";
+        const zonedDateTime = Temporal.Now.zonedDateTimeISO(timeZone);
+        expect(zonedDateTime).toBeInstanceOf(Temporal.ZonedDateTime);
+        expect(zonedDateTime.calendarId).toBe("iso8601");
+        expect(zonedDateTime.timeZoneId).toBe(timeZone);
+    });
+});

Libraries/LibJS/Tests/builtins/Temporal/PlainDate/PlainDate.prototype.toZonedDateTime.js

@@ -0,0 +1,85 @@
+describe("correct behavior", () => {
+    test("length is 1", () => {
+        expect(Temporal.PlainDate.prototype.toZonedDateTime).toHaveLength(1);
+    });
+
+    test("basic functionality - time zone", () => {
+        // 3.b. in the spec
+        const plainDate = new Temporal.PlainDate(2021, 7, 6);
+        const timeZone = "UTC";
+        const zonedDateTime = plainDate.toZonedDateTime(timeZone);
+        expect(zonedDateTime.year).toBe(2021);
+        expect(zonedDateTime.month).toBe(7);
+        expect(zonedDateTime.day).toBe(6);
+        expect(zonedDateTime.hour).toBe(0);
+        expect(zonedDateTime.minute).toBe(0);
+        expect(zonedDateTime.second).toBe(0);
+        expect(zonedDateTime.millisecond).toBe(0);
+        expect(zonedDateTime.microsecond).toBe(0);
+        expect(zonedDateTime.nanosecond).toBe(0);
+        expect(zonedDateTime.calendarId).toBe(plainDate.calendarId);
+        expect(zonedDateTime.timeZoneId).toBe(timeZone);
+    });
+
+    test("basic functionality - time zone like object", () => {
+        // 3.c. in the spec
+        const plainDate = new Temporal.PlainDate(2021, 7, 6);
+        const timeZone = "UTC";
+        const zonedDateTime = plainDate.toZonedDateTime(timeZone);
+        expect(zonedDateTime.year).toBe(2021);
+        expect(zonedDateTime.month).toBe(7);
+        expect(zonedDateTime.day).toBe(6);
+        expect(zonedDateTime.hour).toBe(0);
+        expect(zonedDateTime.minute).toBe(0);
+        expect(zonedDateTime.second).toBe(0);
+        expect(zonedDateTime.millisecond).toBe(0);
+        expect(zonedDateTime.microsecond).toBe(0);
+        expect(zonedDateTime.nanosecond).toBe(0);
+        expect(zonedDateTime.calendarId).toBe(plainDate.calendarId);
+        expect(zonedDateTime.timeZoneId).toBe(timeZone);
+    });
+
+    test("basic functionality - time zone like object and plain time", () => {
+        // 3.c. in the spec
+        const plainDate = new Temporal.PlainDate(2021, 7, 6);
+        const plainTime = new Temporal.PlainTime(18, 14, 47, 123, 456, 789);
+        const timeZone = "UTC";
+        const zonedDateTime = plainDate.toZonedDateTime({ timeZone, plainTime });
+        expect(zonedDateTime.year).toBe(2021);
+        expect(zonedDateTime.month).toBe(7);
+        expect(zonedDateTime.day).toBe(6);
+        expect(zonedDateTime.hour).toBe(18);
+        expect(zonedDateTime.minute).toBe(14);
+        expect(zonedDateTime.second).toBe(47);
+        expect(zonedDateTime.millisecond).toBe(123);
+        expect(zonedDateTime.microsecond).toBe(456);
+        expect(zonedDateTime.nanosecond).toBe(789);
+        expect(zonedDateTime.calendarId).toBe(plainDate.calendarId);
+        expect(zonedDateTime.timeZoneId).toBe(timeZone);
+    });
+
+    test("basic functionality - time zone identifier", () => {
+        // 4. in the spec
+        const plainDate = new Temporal.PlainDate(2021, 7, 6);
+        const zonedDateTime = plainDate.toZonedDateTime("UTC");
+        expect(zonedDateTime.year).toBe(2021);
+        expect(zonedDateTime.month).toBe(7);
+        expect(zonedDateTime.day).toBe(6);
+        expect(zonedDateTime.hour).toBe(0);
+        expect(zonedDateTime.minute).toBe(0);
+        expect(zonedDateTime.second).toBe(0);
+        expect(zonedDateTime.millisecond).toBe(0);
+        expect(zonedDateTime.microsecond).toBe(0);
+        expect(zonedDateTime.nanosecond).toBe(0);
+        expect(zonedDateTime.calendarId).toBe(plainDate.calendarId);
+        expect(zonedDateTime.timeZoneId).toBe("UTC");
+    });
+});
+
+describe("errors", () => {
+    test("this value must be a Temporal.PlainDate object", () => {
+        expect(() => {
+            Temporal.PlainDate.prototype.toZonedDateTime.call("foo");
+        }).toThrowWithMessage(TypeError, "Not an object of type Temporal.PlainDate");
+    });
+});

Libraries/LibJS/Tests/builtins/Temporal/PlainDateTime/PlainDateTime.prototype.toZonedDateTime.js

@@ -0,0 +1,30 @@
+describe("correct behavior", () => {
+    test("length is 1", () => {
+        expect(Temporal.PlainDateTime.prototype.toZonedDateTime).toHaveLength(1);
+    });
+
+    test("basic functionality", () => {
+        const plainDateTime = new Temporal.PlainDateTime(2021, 7, 6, 18, 14, 47, 123, 456, 789);
+        const timeZone = "UTC";
+        const zonedDateTime = plainDateTime.toZonedDateTime(timeZone);
+        expect(zonedDateTime.year).toBe(2021);
+        expect(zonedDateTime.month).toBe(7);
+        expect(zonedDateTime.day).toBe(6);
+        expect(zonedDateTime.hour).toBe(18);
+        expect(zonedDateTime.minute).toBe(14);
+        expect(zonedDateTime.second).toBe(47);
+        expect(zonedDateTime.millisecond).toBe(123);
+        expect(zonedDateTime.microsecond).toBe(456);
+        expect(zonedDateTime.nanosecond).toBe(789);
+        expect(zonedDateTime.calendarId).toBe(plainDateTime.calendarId);
+        expect(zonedDateTime.timeZoneId).toBe(timeZone);
+    });
+});
+
+describe("errors", () => {
+    test("this value must be a Temporal.PlainDateTime object", () => {
+        expect(() => {
+            Temporal.PlainDateTime.prototype.toZonedDateTime.call("foo");
+        }).toThrowWithMessage(TypeError, "Not an object of type Temporal.PlainDateTime");
+    });
+});