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

Syntax

with(info)
with(info, options)

Parameter

info

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

options Optional

Ein Objekt mit der folgenden Eigenschaft:

overflow Optional

Ein String, der das Verhalten angibt, wenn eine Zeitkomponente außerhalb des gültigen 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 gültigen 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, während die restlichen Felder von der ursprünglichen Zeit übernommen werden.

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 gültigen Bereichs liegen und options.overflow auf "reject" gesetzt ist.

Beispiele

Verwendung von with()

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

Weitere Beispiele finden Sie in der Dokumentation zu den einzelnen Eigenschaften, die mit with() festgelegt werden können.

Spezifikationen

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