LibJS: Implement the Temporal.ZonedDateTime constructor

And the simple Temporal.ZonedDateTime.prototype getters, so that the constructed Temporal.ZonedDateTime may actually be validated.
Author: https://github.com/trflynn89 Commit: 8c73cae2b8 Pull-request: https://github.com/LadybirdBrowser/ladybird/pull/2577 Reviewed-by: https://github.com/shannonbooth ✅
2025-09-09 02:56:10 +00:00 · 2024-11-24 20:42:47 -05:00 · 2024-11-24 20:42:47 -05:00 · 8c73cae2b8 · 2024-11-26 10:04:22 +00:00
commit 8c73cae2b8
parent 8ab765a3eb
48 changed files with 1757 additions and 23 deletions
--- a/Libraries/LibJS/Tests/builtins/Temporal/ZonedDateTime/ZonedDateTime.from.js
+++ b/Libraries/LibJS/Tests/builtins/Temporal/ZonedDateTime/ZonedDateTime.from.js
@ -0,0 +1,132 @@
+describe("correct behavior", () => {
+    test("length is 1", () => {
+        expect(Temporal.ZonedDateTime.from).toHaveLength(1);
+    });
+
+    test("ZonedDateTime instance argument", () => {
+        const timeZone = "UTC";
+        const calendar = "gregory";
+        const zonedDateTime = new Temporal.ZonedDateTime(1627318123456789000n, timeZone, calendar);
+        const createdZoneDateTime = Temporal.ZonedDateTime.from(zonedDateTime);
+
+        expect(createdZoneDateTime).toBeInstanceOf(Temporal.ZonedDateTime);
+        expect(createdZoneDateTime).not.toBe(zonedDateTime);
+        expect(createdZoneDateTime.timeZoneId).toBe(timeZone);
+        expect(createdZoneDateTime.calendarId).toBe(calendar);
+        expect(createdZoneDateTime.epochNanoseconds).toBe(1627318123456789000n);
+    });
+
+    test("PlainDate instance argument", () => {
+        const timeZone = "UTC";
+        const calendar = "gregory";
+        const plainDate = new Temporal.PlainDate(2021, 11, 7, calendar);
+        plainDate.timeZone = timeZone;
+        const createdZoneDateTime = Temporal.ZonedDateTime.from(plainDate);
+
+        expect(createdZoneDateTime).toBeInstanceOf(Temporal.ZonedDateTime);
+        expect(createdZoneDateTime.timeZoneId).toBe(timeZone);
+        expect(createdZoneDateTime.calendarId).toBe(calendar);
+        expect(createdZoneDateTime.year).toBe(2021);
+        expect(createdZoneDateTime.month).toBe(11);
+        expect(createdZoneDateTime.day).toBe(7);
+    });
+
+    test("PlainDateTime instance argument", () => {
+        const timeZone = "UTC";
+        const calendar = "gregory";
+        const plainDateTime = new Temporal.PlainDateTime(
+            2021,
+            11,
+            7,
+            0,
+            20,
+            5,
+            100,
+            200,
+            300,
+            calendar
+        );
+        plainDateTime.timeZone = timeZone;
+        const createdZoneDateTime = Temporal.ZonedDateTime.from(plainDateTime);
+
+        expect(createdZoneDateTime).toBeInstanceOf(Temporal.ZonedDateTime);
+        expect(createdZoneDateTime.timeZoneId).toBe(timeZone);
+        expect(createdZoneDateTime.calendarId).toBe(calendar);
+        expect(createdZoneDateTime.year).toBe(2021);
+        expect(createdZoneDateTime.month).toBe(11);
+        expect(createdZoneDateTime.day).toBe(7);
+        expect(createdZoneDateTime.hour).toBe(0);
+        expect(createdZoneDateTime.minute).toBe(20);
+        expect(createdZoneDateTime.second).toBe(5);
+        expect(createdZoneDateTime.millisecond).toBe(100);
+        expect(createdZoneDateTime.microsecond).toBe(200);
+        expect(createdZoneDateTime.nanosecond).toBe(300);
+    });
+
+    test("ZonedDateTime-like argument", () => {
+        const timeZone = "UTC";
+        const calendar = "gregory";
+        const zdtLike = {
+            timeZone,
+            calendar,
+            year: 2021,
+            month: 11,
+            day: 7,
+            hour: 0,
+            minute: 20,
+            second: 5,
+            millisecond: 100,
+            microsecond: 200,
+            nanosecond: 300,
+        };
+        const createdZoneDateTime = Temporal.ZonedDateTime.from(zdtLike);
+
+        expect(createdZoneDateTime).toBeInstanceOf(Temporal.ZonedDateTime);
+        expect(createdZoneDateTime.timeZoneId).toBe(timeZone);
+        expect(createdZoneDateTime.calendarId).toBe(calendar);
+        expect(createdZoneDateTime.year).toBe(2021);
+        expect(createdZoneDateTime.month).toBe(11);
+        expect(createdZoneDateTime.day).toBe(7);
+        expect(createdZoneDateTime.hour).toBe(0);
+        expect(createdZoneDateTime.minute).toBe(20);
+        expect(createdZoneDateTime.second).toBe(5);
+        expect(createdZoneDateTime.millisecond).toBe(100);
+        expect(createdZoneDateTime.microsecond).toBe(200);
+        expect(createdZoneDateTime.nanosecond).toBe(300);
+    });
+
+    test("from string", () => {
+        const zonedDateTime = Temporal.ZonedDateTime.from(
+            "2021-11-07T00:20:05.100200300+00:00[UTC][u-ca=iso8601]"
+        );
+
+        expect(zonedDateTime).toBeInstanceOf(Temporal.ZonedDateTime);
+        expect(zonedDateTime.timeZoneId).toBe("UTC");
+        expect(zonedDateTime.calendarId).toBe("iso8601");
+        expect(zonedDateTime.year).toBe(2021);
+        expect(zonedDateTime.month).toBe(11);
+        expect(zonedDateTime.day).toBe(7);
+        expect(zonedDateTime.hour).toBe(0);
+        expect(zonedDateTime.minute).toBe(20);
+        expect(zonedDateTime.second).toBe(5);
+        expect(zonedDateTime.millisecond).toBe(100);
+        expect(zonedDateTime.microsecond).toBe(200);
+        expect(zonedDateTime.nanosecond).toBe(300);
+        expect(zonedDateTime.offset).toBe("+00:00");
+        expect(zonedDateTime.offsetNanoseconds).toBe(0);
+    });
+});
+
+describe("errors", () => {
+    test("requires timeZone property", () => {
+        expect(() => {
+            Temporal.ZonedDateTime.from({});
+        }).toThrowWithMessage(TypeError, "Required property timeZone is missing or undefined");
+    });
+
+    test("invalid zoned date time string", () => {
+        expect(() => {
+            Temporal.ZonedDateTime.from("foo");
+        }).toThrowWithMessage(RangeError, "Invalid ISO date time");
+    });
+});