JavaScript Temporal Instant valueOf()
Example
const instant = Temporal.Instant.from("2026-05-17T14:30:00Z");
try {
let text = instant.valueOf();
} catch (err) {
text = err.name;
}
Try it Yourself »
TypeError: Cannot convert Temporal.Instant to a number.
Description
The valueOf() method throws a TypeError.
This prevents temporal instances from being implicitly converted to primitives.
The valueOf() method does not change the original Instant.
Note
Temporal objects do not allow implicit conversion to numbers.
This prevents accidental errors when working with dates and times.
Syntax
instant.valueOf()
Parameters
| NONE |
Return Value
| NONE |
Browser Support
Temporal is a major update to the JavaScript standard (TC39).
It is currently supported in Chrome, Edge, Firefox, and Opera and is expected to reach full availability across browsers before the summer of 2026.
| Chrome 144 |
Edge 144 |
Firefox 139 |
Safari |
Opera 128 |
| Jan 2026 | Jan 2026 | May 2025 | 🚫 | Feb 2026 |
The Safari implementation can be tested in Safari Technology Preview by enabling the --use-temporal runtime flag.
Polyfill
Until Safari support Temporal natively, you can use the official polyfill:
<script
src="https://cdn.jsdelivr.net/npm/@js-temporal/polyfill/dist/index.umd.js">
</script>
