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 von Temporal.PlainTime gibt ein neues Temporal.PlainTime-Objekt zurück, das diese Zeit mit einigen Feldern darstellt, welche durch neue Werte ersetzt wurden. Da alle Temporal-Objekte so konzipiert sind, dass sie unveränderlich 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 von
Temporal.PlainTime.from()anerkannten Eigenschaften enthält:hour,microsecond,millisecond,minute,nanosecond,second. Nicht angegebene Eigenschaften verwenden die Werte der ursprünglichen Zeit. optionsOptional-
Ein Objekt, das die folgende Eigenschaft enthält:
overflowOptional-
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 beschränkt.
"reject"-
Ein
RangeErrorwird 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 von der ursprünglichen Zeit kopiert werden.
Ausnahmen
TypeError-
Wird in einem der folgenden Fälle ausgelöst:
infoist kein Objekt mit mindestens einer anerkannten Eigenschaft oder einem String.optionsist kein Objekt oderundefined.
RangeError-
Wird ausgelöst, wenn die angegebenen numerischen Eigenschaften außerhalb des Bereichs liegen und
options.overflowauf"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'
Für weitere Beispiele siehe die Dokumentation zu den einzelnen Eigenschaften, die mit with() gesetzt werden können.
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaintime.prototype.with |
Browser-Kompatibilität
Loading…