feat(unstable): add Temporal API support (#21738)

This commit adds support for [Stage 3 Temporal API
proposal](https://tc39.es/proposal-temporal/docs/).

The API is available when `--unstable-temporal` flag is passed.

---------

Signed-off-by: Bartek Iwańczuk <biwanczuk@gmail.com>
Co-authored-by: David Sherret <dsherret@gmail.com>
Co-authored-by: Kenta Moriuchi <moriken@kimamass.com>

4 files changed, 88 insertions, 0 deletions

diff --git a/cli/tests/testdata/run/unstable_temporal_api/main.out b/cli/tests/testdata/run/unstable_temporal_api/main.out
new file mode 100644
index 000000000..46d25c3ea
--- /dev/null
+++ b/cli/tests/testdata/run/unstable_temporal_api/main.out
@@ -0,0 +1,12 @@
+Check [WILDCARD]
+Temporal.Now [WILDCARD]
+Temporal.Instant 1969-07-20T20:17:00Z
+Temporal.ZonedDateTime 1995-12-07T03:24:30.0000035-08:00[America/Los_Angeles]
+Temporal.PlainDate 2006-08-24
+Temporal.PlainTime 19:39:09.068346205
+Temporal.PlainDateTime 1995-12-07T15:00:00
+Temporal.PlainYearMonth 2020-10
+Temporal.PlainMonthDay 07-14
+Temporal.Duration PT130H20M
+Temporal.TimeZone Africa/Cairo
+Temporal.Calendar 1999-12-31
diff --git a/cli/tests/testdata/run/unstable_temporal_api/main.ts b/cli/tests/testdata/run/unstable_temporal_api/main.ts
new file mode 100644
index 000000000..1641b90bf
--- /dev/null
+++ b/cli/tests/testdata/run/unstable_temporal_api/main.ts
@@ -0,0 +1,71 @@
+console.log("Temporal.Now", Temporal.Now.instant());
+console.log(
+  "Temporal.Instant",
+  Temporal.Instant.from("1969-07-20T20:17Z"),
+);
+console.log(
+  "Temporal.ZonedDateTime",
+  Temporal.ZonedDateTime.from({
+    timeZone: "America/Los_Angeles",
+    year: 1995,
+    month: 12,
+    day: 7,
+    hour: 3,
+    minute: 24,
+    second: 30,
+    millisecond: 0,
+    microsecond: 3,
+    nanosecond: 500,
+  }),
+);
+console.log(
+  "Temporal.PlainDate",
+  Temporal.PlainDate.from({ year: 2006, month: 8, day: 24 }),
+);
+console.log(
+  "Temporal.PlainTime",
+  Temporal.PlainTime.from({
+    hour: 19,
+    minute: 39,
+    second: 9,
+    millisecond: 68,
+    microsecond: 346,
+    nanosecond: 205,
+  }),
+);
+console.log(
+  "Temporal.PlainDateTime",
+  Temporal.PlainDateTime.from({
+    year: 1995,
+    month: 12,
+    day: 7,
+    hour: 15,
+  }),
+);
+console.log(
+  "Temporal.PlainYearMonth",
+  Temporal.PlainYearMonth.from({ year: 2020, month: 10 }),
+);
+console.log(
+  "Temporal.PlainMonthDay",
+  Temporal.PlainMonthDay.from({ month: 7, day: 14 }),
+);
+console.log(
+  "Temporal.Duration",
+  Temporal.Duration.from({
+    hours: 130,
+    minutes: 20,
+  }),
+);
+console.log(
+  "Temporal.TimeZone",
+  Temporal.TimeZone.from("Africa/Cairo"),
+);
+console.log(
+  "Temporal.Calendar",
+  Temporal.Calendar.from("iso8601").dateFromFields({
+    year: 1999,
+    month: 12,
+    day: 31,
+  }, {}),
+);
diff --git a/cli/tests/testdata/run/unstable_temporal_api/missing_flag.js b/cli/tests/testdata/run/unstable_temporal_api/missing_flag.js
new file mode 100644
index 000000000..92aed7931
--- /dev/null
+++ b/cli/tests/testdata/run/unstable_temporal_api/missing_flag.js
@@ -0,0 +1 @@
+Temporal.Now.instant();
diff --git a/cli/tests/testdata/run/unstable_temporal_api/missing_flag.out b/cli/tests/testdata/run/unstable_temporal_api/missing_flag.out
new file mode 100644
index 000000000..8f8e23e70
--- /dev/null
+++ b/cli/tests/testdata/run/unstable_temporal_api/missing_flag.out
@@ -0,0 +1,4 @@
+error: Uncaught (in promise) ReferenceError: Temporal is not defined
+Temporal.Now.instant();
+^
+    at [WILDCARD]missing_flag.js:1:1