JS Temporal Differences
JavaScript since() and until()
The since() method calculates the since duration between two dates.
The until() method calculates the until duration between two dates.
The since() and until() are effectivly the inverse of each other.
All temporal date objects have their own since() method:
- plaindate.since(plaindate)
- plaintime.since(plaintime)
- plainyearmonth.since(plainyearmonth)
- plainmonthday.since(plainmonthday)
- plaindatetime.since(plaindatetime)
- zoneddatetime.since(zoneddatetime)
- instant.since(instant)
All temporal objects have their own until() method:
- plaindate.until(plaindate)
- plaintime.until(plaintime)
- plainyearmonth.until(plainyearmonth)
- plainmonthday.until(plainmonthday)
- plaindatetime.until(plaindatetime)
- zoneddatetime.until(zoneddatetime)
- instant.until(instant)
JavaScript Temporal since()
The since() method calculates the duration between two temporal dates.
Syntax
Meaning
At time t1, how much time has passed since time t2 ?
Example
const end = Temporal.PlainDate.from("2026-05-17");
const duration = start.since(end);
The since() method returns a Temporal.Duration Object
representing the elapsed time.
The duration is positive if the "other" date is in the past.
The duration is negative if the "other" date is in the future.
JavaScript Temporal until()
The until() method calculates the duration between two temporal dates.
The until() method is effectively the inverse of the
since() method.
Syntax
Meaning
At time t1, how much time is it until t2 ?
Example
const end = Temporal.PlainDate.from("2026-05-17");
const duration = start.until(end);
Temporal since() vs until()
The methods are opposites.
| Method | Meaning |
|---|---|
| a.since(b) | time from b → a |
| a.until(b) | time from a → b |
Example
const end = Temporal.PlainDate.from("2026-05-17");
const duration1 = start.since(end);
const duration2 = start.until(end);
Think:
- since = past (since yesterday)
- until = future (until tomorrow)
The Options Parameters
Example
const today = Temporal.Now.plainDateISO();
const duration = today.since(wedding);
The since() method returns the total number of days,
but you can use the largestUnit option to break it down into years and months:
Example
const today = Temporal.Now.plainDateISO();
const duration = today.since(wedding, {largestUnit:'years'});
PlainTime since()
Example: Plain Time
const end = Temporal.PlainTime.from("17:30");
const duration = end.since(start);
ZonedDateTime since()
The since() method calculates the duration between two temporal dates.
Syntax
Example: ZonedDateTime
"2026-02-17T09:00:00+01:00[Europe/Oslo]");
const end = Temporal.ZonedDateTime.from(
"2026-02-17T17:30:00+01:00[Europe/Oslo]");
const duration = end.since(start);