Temporal.PlainTime.prototype.since()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die since() Methode von Temporal.PlainTime Instanzen gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von einer anderen Zeit (in einer Form, die von Temporal.PlainTime.from() konvertierbar ist) zu dieser Zeit darstellt. Die Dauer ist positiv, wenn die andere Zeit vor dieser Zeit liegt, und negativ, wenn nach dieser.

Diese Methode führt this - other aus. Um other - this auszuführen, verwenden Sie die until() Methode.

Syntax

js
since(other)
since(other, options)

Parameter

other

Ein String, ein Objekt oder eine Temporal.PlainTime Instanz, die eine von dieser Zeit abzuziehende Zeit darstellt. Es wird unter Verwendung des gleichen Algorithmus wie Temporal.PlainTime.from() in ein Temporal.PlainTime Objekt umgewandelt.

options Optional

Ein Objekt, das die Optionen für Temporal.Duration.prototype.round() enthält, einschließlich largestUnit, roundingIncrement, roundingMode und smallestUnit. largestUnit und smallestUnit akzeptieren nur die Einheiten: "hour", "minute", "second", "millisecond", "microsecond", "nanosecond" oder deren Pluralformen. Für largestUnit bedeutet der Standardwert "auto" "hour". Für smallestUnit ist der Standardwert "nanosecond".

Rückgabewert

Ein neues Temporal.Duration Objekt, das die Dauer seit other bis zu dieser Zeit darstellt. Die Dauer ist positiv, wenn other vor dieser Zeit liegt, und negativ, wenn nach dieser.

Ausnahmen

RangeError

Wird ausgelöst, wenn eine der Optionen ungültig ist.

Beispiele

Verwendung von since()

js
const lunchTime = Temporal.PlainTime.from("12:30:00");
const now = Temporal.Now.plainTimeISO();
const duration = now.since(lunchTime);
console.log(`You had lunch ${duration.toLocaleString("en-US")} ago`);
// Example output: "You had lunch 3 hr, 42 min, 21 sec, 343 ms, 131 μs, 718 ns ago"

const duration2 = now.since(lunchTime, { smallestUnit: "minute" });
console.log(`You had lunch ${duration2.toLocaleString("en-US")} ago`);
// Example output: "You had lunch 3 hr, 42 min ago"

const duration3 = now.since(lunchTime, {
  largestUnit: "minute",
  smallestUnit: "minute",
});
console.log(`You had lunch ${duration3.toLocaleString("en-US")} ago`);
// Example output: "You had lunch 222 min ago"

Ergebnis runden

Standardmäßig wird der Bruchteil von smallestUnit abgeschnitten. Sie können ihn mit den Optionen roundingIncrement und roundingMode runden.

js
const time1 = Temporal.PlainTime.from("12:30:00");
const time2 = Temporal.PlainTime.from("12:30:01");
const duration = time2.since(time1, {
  smallestUnit: "second",
  roundingIncrement: 15,
  roundingMode: "ceil",
});
console.log(duration.toString()); // "PT15S"

Spezifikationen

Specification
Temporal proposal
# sec-temporal.plaintime.prototype.since

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch