Temporal.Duration.prototype.with()

info

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

Ein neues Temporal.Duration-Objekt, bei dem die in info angegebenen Felder, die nicht undefined sind, durch die entsprechenden Werte ersetzt werden, und der Rest der Felder von der ursprünglichen Dauer kopiert wird.

RangeError

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

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

TypeError

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

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

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

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

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