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 Safari has not shipped it yet.
| 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 supports Temporal natively, you can use the official polyfill:
<script
src="https://cdn.jsdelivr.net/npm/@js-temporal/polyfill@0.5.1/dist/index.umd.js">
</script>
