Temporal.PlainDateTime.prototype.withPlainTime()
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 withPlainTime()-Methode von Temporal.PlainDateTime-Instanzen gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum-Uhrzeit darstellt, wobei der Uhrzeitteil vollständig durch die neue Uhrzeit ersetzt wird (in einer Form, die durch Temporal.PlainTime.from() umgewandelt werden kann).
Diese Methode ersetzt alle Uhrzeiteigenschaften und setzt nicht angegebene Eigenschaften standardmäßig auf 0. Wenn Sie nur einige der Uhrzeiteigenschaften ersetzen möchten, verwenden Sie stattdessen die Methode with().
Syntax
withPlainTime()
withPlainTime(plainTime)
Parameter
plainTimeOptional-
Ein String, ein Objekt oder eine
Temporal.PlainTime-Instanz, die die neue Uhrzeit darstellt. Es wird mit demselben Algorithmus wieTemporal.PlainTime.from()in einTemporal.PlainTime-Objekt umgewandelt. Wenn nicht angegeben, wird der Uhrzeitteil auf00:00:00gesetzt.
Rückgabewert
Ein neues Temporal.PlainDateTime-Objekt, bei dem der Datumsteil von dem ursprünglichen Datum-Uhrzeit kopiert und der Uhrzeitteil durch die neue Uhrzeit ersetzt wird.
Beispiele
Verwendung von withPlainTime()
const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");
// You can pass a string
const newDT = dt.withPlainTime("13:45:00");
console.log(newDT.toString()); // "2021-07-01T13:45:00"
// You can only specify some time properties, and the rest default to 0;
// for the with() method, they would be copied from the original date-time
const newDT2 = dt.withPlainTime({ hour: 13 });
console.log(newDT2.toString()); // "2021-07-01T13:00:00"
// You can pass nothing to set the time to midnight
const newDT3 = dt.withPlainTime();
console.log(newDT3.toString()); // "2021-07-01T00:00:00"
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.withplaintime |
Browser-Kompatibilität
Loading…