The since() method of Temporal.Instant instances returns a new Temporal.Duration object representing the duration from another instant (in a form convertible by Temporal/Instant/from) to this instant. The duration is positive if the other instant is before this instant, and negative if after.
This method does this - other. To do other - this, use the Temporal/Instant/until method.
Syntax
since(other)
since(other, options)
Parameters
other- : A string or a Temporal.Instant instance representing an instant to subtract from this instant. It is converted to a
Temporal.Instantobject using the same algorithm as Temporal/Instant/from.
- : A string or a Temporal.Instant instance representing an instant to subtract from this instant. It is converted to a
options- : An object containing the options for Temporal/Duration/round, which includes
largestUnit,roundingIncrement,roundingMode, andsmallestUnit.largestUnitandsmallestUnitonly accept the units:"hours","minutes","seconds","milliseconds","microseconds","nanoseconds", or their singular forms. ForlargestUnit, the default value"auto"means"seconds"orsmallestUnit, whichever is greater. ForsmallestUnit, the default value is"nanoseconds".
- : An object containing the options for Temporal/Duration/round, which includes
Return value
A new Temporal.Duration object representing the duration since other to this instant. The duration is positive if other is before this instant, and negative if after.
Exceptions
- RangeError
- : Thrown if any of the options is invalid.
Examples
Using since()
const lastUpdated = Temporal.Instant.fromEpochMilliseconds(1735235418000);
const now = Temporal.Now.instant();
const duration = now.since(lastUpdated, { smallestUnit: "minute" });
console.log(`Last updated ${duration.toLocaleString("en-US")} ago`);
Balancing the resulting duration
Because an instant does not carry calendar information, the resulting duration avoids calendar durations, which are ambiguous without a calendar and time reference. Therefore, the result is unbalanced because hours may be greater than 24. To balance the duration, round the resulting duration again with the desired largestUnit, passing a relativeTo that carries the calendar information.
const lastUpdated = Temporal.Instant.fromEpochMilliseconds(1735235418000);
const now = Temporal.Now.instant();
const duration = now.since(lastUpdated, { smallestUnit: "minutes" });
const roundedDuration = duration.round({
largestUnit: "years",
// Use the ISO calendar; you can convert to another calendar using
// withCalendar()
relativeTo: now.toZonedDateTimeISO("UTC"),
});
console.log(`Last updated ${roundedDuration.toLocaleString("en-US")} ago`);
Specifications
Browser compatibility
See also
- Temporal.Instant
- Temporal.Duration
- Temporal/Instant/add
- Temporal/Instant/subtract
- Temporal/Instant/until
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
