37515 Firefox Nightly supports Temporal behind pref (#37863)

* added experimental release note for Temporal API * added Temporal to FF135 release note in experimental features * Update files/en-us/mozilla/firefox/experimental_features/index.md Co-authored-by: Brian Smith <[email protected]> * Update files/en-us/mozilla/firefox/releases/135/index.md Co-authored-by: Brian Smith <[email protected]> * Update files/en-us/mozilla/firefox/experimental_features/index.md Co-authored-by: Brian Smith <[email protected]> * Update files/en-us/mozilla/firefox/experimental_features/index.md Co-authored-by: Brian Smith <[email protected]> * Update files/en-us/mozilla/firefox/experimental_features/index.md Co-authored-by: Brian Smith <[email protected]> * Update files/en-us/mozilla/firefox/experimental_features/index.md Co-authored-by: Brian Smith <[email protected]> --------- Co-authored-by: Brian Smith <[email protected]>
mdn · Jan 30, 2025 · 19f8302 · 19f8302
1 parent 38b5682
commit 19f8302
Show file tree

Hide file tree

Showing 2 changed files with 55 additions and 0 deletions.
diff --git a/files/en-us/mozilla/firefox/experimental_features/index.md b/files/en-us/mozilla/firefox/experimental_features/index.md
@@ -948,6 +948,60 @@ None.
   </tbody>
 </table>
 
+### Temporal API
+
+The [Temporal object](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Temporal) aims to simplify working with dates and times in various scenarios, with built-in time zone and calendar representations ([Firefox bug 1912511](https://bugzil.la/1912511)).
+This includes:
+
+- A **duration** (difference between two time points): {{jsxref("Temporal.Duration")}}
+- **Points in time**:
+  - As a unique instant in history:
+    - A timestamp: {{jsxref("Temporal.Instant")}}
+    - A date-time with a time zone: {{jsxref("Temporal.ZonedDateTime")}}
+  - **Time-zone-unaware date/time ("Plain")**:
+    - Date (year, month, day) + time (hour, minute, second, millisecond, nanosecond): {{jsxref("Temporal.PlainDateTime")}}
+      - Date (year, month, day): {{jsxref("Temporal.PlainDate")}}
+        - Year, month: {{jsxref("Temporal.PlainYearMonth")}}
+        - Month, day: {{jsxref("Temporal.PlainMonthDay")}}
+      - Time (hour, minute, second, millisecond, nanosecond): {{jsxref("Temporal.PlainTime")}}
+- **Now** (current time) as various class instances, or in a specific format: {{jsxref("Temporal.Now")}}
+
+<table>
+  <thead>
+    <tr>
+      <th>Release channel</th>
+      <th>Version added</th>
+      <th>Enabled by default?</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <th>Nightly</th>
+      <td>135</td>
+      <td>No</td>
+    </tr>
+    <tr>
+      <th>Developer Edition</th>
+      <td>—</td>
+      <td>—</td>
+    </tr>
+    <tr>
+      <th>Beta</th>
+      <td>—</td>
+      <td>—</td>
+    </tr>
+    <tr>
+      <th>Release</th>
+      <td>—</td>
+      <td>—</td>
+    </tr>
+    <tr>
+      <th>Preference name</th>
+      <td colspan="2"><code>javascript.options.experimental.temporal</code></td>
+    </tr>
+  </tbody>
+</table>
+
 ## APIs
 
 ### Cookie Store API

diff --git a/files/en-us/mozilla/firefox/releases/135/index.md b/files/en-us/mozilla/firefox/releases/135/index.md
@@ -96,6 +96,7 @@ This article provides information about the changes in Firefox 135 that affect d
 
 These features are newly shipped in Firefox 135 but are disabled by default. To experiment with them, search for the appropriate preference on the `about:config` page and set it to `true`. You can find more such features on the [Experimental features](/en-US/docs/Mozilla/Firefox/Experimental_features) page.
 
+- **Temporal API** (Nightly release): <code>javascript.options.experimental.temporal</code>. The [Temporal object](/en-US/docs/Web/JavaScript/Reference/Global_Objects/Temporal) aims to simplify working with dates and times in various scenarios, with built-in time zone and calendar representations. ([Firefox bug 1912511](https://bugzil.la/1912511)).
 - **Prioritized Task Scheduling API**: <code>dom.enable_web_task_scheduling</code>.
   The [Prioritized Task Scheduling API](/en-US/docs/Web/API/Prioritized_Task_Scheduling_API) provides a standardized way to prioritize all tasks belonging to an application, whether they defined in a website developer's code, or in third party libraries and frameworks.
   This has temporarily been disabled in Nightly builds in order to avoid [breakage in-the-wild](https://bugzil.la/1937232).