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 Instanzen des Temporal.PlainDateTime gibt ein neues Temporal.PlainDateTime-Objekt zurück, das diesen Datum-Uhrzeit-Wert darstellt, wobei der Uhrzeit-Teil vollständig durch die neue Uhrzeit ersetzt wird (in einer Form, die durch Temporal.PlainTime.from() umgewandelt werden kann).
Diese Methode wird alle Uhrzeiteigenschaften ersetzen und standardmäßig 0 verwenden, wenn Eigenschaften nicht angegeben sind. Wenn Sie nur einige der Uhrzeiteigenschaften ersetzen möchten, verwenden Sie stattdessen die with() Methode.
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 in einTemporal.PlainTime-Objekt umgewandelt wieTemporal.PlainTime.from(). Wenn nicht angegeben, wird der Uhrzeit-Teil auf00:00:00gesetzt.
Rückgabewert
Ein neues Temporal.PlainDateTime-Objekt, mit dem Datumsanteil vom ursprünglichen Datum-Uhrzeit-Wert kopiert und dem Uhrzeit-Teil durch die neue Uhrzeit ersetzt.
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 |