JavaScript PlainTime until()
Example
const start = Temporal.PlainTime.from("14:30:00");
const end = Temporal.PlainTime.from("15:30:00");
const duration = end.until(start, {smallestUnit:"hours"});
Try it Yourself »
Description
The until() method returns a Temporal.Duration object representing
the duration from this PlainTime until another PlainTime.
The until() method does not change the original PlainTime object.
Syntax
plaintime.until(other, option)
Parameters
| Parameter | Description |
| other | Another PlainTime. |
| option | Any valid Temporal.Duration.round() option. |
Return Value
| Type | Description |
| Object | A Temporal.Duration object representing the duration until the other time. |
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>
