Temporal.PlainDateTime.prototype.withPlainTime()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die withPlainTime()-Methode von Temporal.PlainDateTime-Instanzen gibt ein neues Temporal.PlainDateTime-Objekt zurück, das dieses Datum und diese Uhrzeit darstellt, wobei der Zeitteil vollständig durch die neue Zeit ersetzt wird (in einer Form, die durch Temporal.PlainTime.from() konvertierbar ist).

Diese Methode ersetzt alle Zeiteigenschaften und verwendet 0 als Standard, falls Eigenschaften nicht angegeben sind. Wenn Sie nur einige der Zeiteigenschaften ersetzen möchten, verwenden Sie stattdessen die with()-Methode.

Syntax

withPlainTime()
withPlainTime(plainTime)

Parameter

plainTime Optional: Ein String, ein Objekt oder eine Temporal.PlainTime-Instanz, die die neue Zeit darstellt. Es wird unter Verwendung desselben Algorithmus wie Temporal.PlainTime.from() in ein Temporal.PlainTime-Objekt konvertiert. Wenn nicht angegeben, wird der Zeitteil auf 00:00:00 gesetzt.

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"