Temporal.Duration.prototype.with()

Syntax

with(info)

Parameter

info

Ein Objekt, das mindestens eine der von Temporal.Duration.from() erkannten Eigenschaften enthält: years, months, weeks, days, hours, minutes, seconds, milliseconds, microseconds, nanoseconds. Nicht angegebene Eigenschaften verwenden die Werte der ursprünglichen Dauer.

Rückgabewert

Ein neues Temporal.Duration Objekt, bei dem die Felder, die in info spezifiziert und nicht undefined sind, durch die entsprechenden Werte ersetzt werden, während die restlichen Felder von der ursprünglichen Dauer übernommen werden.

Ausnahmen

RangeError

Wird in einem der folgenden Fälle ausgelöst:

• Eine der erkannten Eigenschaften im info Objekt ist keine ganze Zahl (einschließlich nicht endlicher Werte).
• Eine Kalendereinheit (Jahre, Monate, Wochen) hat einen absoluten Wert ≥ 2³².
• Der nicht-kalendarische Teil der Dauer (Tage und darunter), ausgedrückt in Sekunden, hat einen absoluten Wert ≥ 2⁵³.

TypeError

Wird in einem der folgenden Fälle ausgelöst:

• Das info Objekt ist kein Objekt.
• Alle erkannten Eigenschaften im info Objekt sind undefined.

Beispiele

Verwendung von with()

Sie können with() verwenden, um eine feingranulare Kontrolle über die Felder eines Temporal.Duration Objekts zu erreichen. Zum Beispiel können Sie eine Dauer manuell nur auf einer Einheit ausbalancieren, was round() nicht anbietet:

function balanceMinutes(duration) {
  const { hours, minutes } = duration;
  const totalMinutes = hours * 60 + minutes;
  const balancedMinutes = totalMinutes % 60;
  const balancedHours = (totalMinutes - balancedMinutes) / 60;
  return duration.with({ hours: balancedHours, minutes: balancedMinutes });
}

const d1 = Temporal.Duration.from({ hours: 100, minutes: 100, seconds: 100 });
const d2 = balanceMinutes(d1);
console.log(d2.hours); // 101
console.log(d2.minutes); // 40
console.log(d2.seconds); // 100; remains unbalanced

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Temporal.Duration
• Temporal.Duration.from()
• Temporal.Duration.prototype.add()
• Temporal.Duration.prototype.subtract()
• Temporal.Duration.prototype.round()