Temporal.PlainTime.prototype.with()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die with() Methode von Temporal.PlainTime Instanzen gibt ein neues Temporal.PlainTime Objekt zurück, das diese Zeit mit einigen Feldern repräsentiert, die 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 von
Temporal.PlainTime.from()erkannten Eigenschaften enthält:hour,microsecond,millisecond,minute,nanosecond,second. Nicht spezifizierte Eigenschaften verwenden die Werte der ursprünglichen Zeit. optionsOptional-
Ein Objekt, das die folgende Eigenschaft enthält:
overflowOptional-
Ein String, der das Verhalten spezifiziert, 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
RangeErrorwird 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 und der Rest der Felder von der ursprünglichen Zeit kopiert wird.
Ausnahmen
TypeError-
Wird in einem der folgenden Fälle ausgelöst:
infoist kein Objekt mit mindestens einer erkannten Eigenschaft oder ein String.optionsist kein Objekt oderundefined.
RangeError-
Wird ausgelöst, wenn die angegebenen numerischen Eigenschaften außerhalb des gültigen 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 der einzelnen Eigenschaften, die mit with() gesetzt werden können.
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaintime.prototype.with |