Temporal.Instant.prototype.since()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die since() Methode von Temporal.Instant Instanzen gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von einem anderen Zeitpunkt (in einer Form, die durch Temporal.Instant.from() konvertierbar ist) bis zu diesem Zeitpunkt darstellt. Die Dauer ist positiv, wenn der andere Zeitpunkt vor diesem Zeitpunkt liegt, und negativ, wenn danach.
Diese Methode führt this - other aus. Um other - this zu berechnen, verwenden Sie die until() Methode.
Syntax
since(other)
since(other, options)
Parameter
other-
Ein String oder eine
Temporal.InstantInstanz, die einen Zeitpunkt darstellt, der von diesem Zeitpunkt abgezogen werden soll. Es wird mithilfe desselben Algorithmus wieTemporal.Instant.from()in einTemporal.InstantObjekt konvertiert. optionsOptional-
Ein Objekt, das die Optionen für
Temporal.Duration.prototype.round()enthält, zu denenlargestUnit,roundingIncrement,roundingModeundsmallestUnitgehören.largestUnitundsmallestUnitakzeptieren nur die Einheiten:"hours","minutes","seconds","milliseconds","microseconds","nanoseconds"oder deren Singularformen. FürlargestUnitbedeutet der Standardwert"auto""seconds"odersmallestUnit, je nachdem, welches größer ist. FürsmallestUnitist der Standardwert"nanoseconds".
Rückgabewert
Ein neues Temporal.Duration Objekt, das die Dauer seit other bis zu diesem Zeitpunkt darstellt. Die Dauer ist positiv, wenn other vor diesem Zeitpunkt ist, und negativ, wenn danach.
Ausnahmen
RangeError-
Wird ausgelöst, wenn eine der Optionen ungültig ist.
Beispiele
Verwendung von 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`);
Ausbalancieren der resultierenden Dauer
Da ein Zeitpunkt keine Kalenderinformationen enthält, vermeidet die resultierende Dauer Kalenderdauern, die ohne Kalender- und Zeitreferenz mehrdeutig sind. Daher ist das Ergebnis unausgeglichen, da hours größer als 24 sein kann. Um die Dauer auszugleichen, runden Sie die resultierende Dauer erneut mit der gewünschten largestUnit und übergeben Sie ein relativeTo, das die Kalenderinformationen enthält.
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`);
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.instant.prototype.since |