Temporal.PlainTime.prototype.with()

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 Methode with() von Temporal.PlainTime-Instanzen gibt ein neues Temporal.PlainTime-Objekt zurück, das diese Zeit mit einigen durch neue Werte ersetzten Feldern darstellt. Da alle Temporal-Objekte unveränderlich konzipiert sind, fungiert diese Methode im Wesentlichen als Setter für die Felder der Zeit.

Syntax

js
with(info)
with(info, options)

Parameter

info

Ein Objekt, das mindestens eine der durch Temporal.PlainTime.from() anerkannten Eigenschaften enthält: hour, microsecond, millisecond, minute, nanosecond, second. Nicht angegebene Eigenschaften verwenden die Werte der ursprünglichen Zeit.

options Optional

Ein Objekt, das die folgende Eigenschaft enthält:

overflow Optional

Ein String, der das Verhalten angibt, wenn eine Zeitkomponente außerhalb des Bereichs liegt. Mögliche Werte sind:

"constrain" (Standard)

Die Zeitkomponente wird auf den gültigen Bereich begrenzt.

"reject"

Ein RangeError wird ausgelöst, wenn die Zeitkomponente außerhalb des Bereichs liegt.

Rückgabewert

Ein neues Temporal.PlainTime-Objekt, bei dem die in info angegebenen Felder, die nicht undefined sind, durch die entsprechenden Werte ersetzt werden, und die restlichen Felder werden von der ursprünglichen Zeit übernommen.

Ausnahmen

TypeError

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

  • info ist kein Objekt mit mindestens einer anerkannten Eigenschaft oder einem String.
  • options ist kein Objekt oder undefined.
RangeError

Wird ausgelöst, wenn die angegebenen numerischen Eigenschaften außerhalb des Bereichs liegen und options.overflow auf "reject" gesetzt ist.

Beispiele

Verwendung von with()

js
const time = Temporal.PlainTime.from("12:34:56.123456789");
const newTime = time.with({ hour: 23 });
console.log(newTime.toString()); // '23:34:56.123456789'

Für weitere Beispiele lesen Sie die Dokumentation für die einzelnen Eigenschaften, die mit with() gesetzt werden können.

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch