Temporal.ZonedDateTime.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.ZonedDateTime Instanzen gibt ein neues Temporal.ZonedDateTime Objekt zurück, das dieses Datum-Uhrzeit mit dem Zeitteil vollständig durch die neue Zeit ersetzt darstellt (in einer Form, die durch Temporal.PlainTime.from() konvertierbar ist).

Diese Methode wird alle Zeit-Eigenschaften ersetzen, wobei bei nicht spezifizierten Eigenschaften standardmäßig 0 verwendet wird. Wenn Sie nur einige der Zeit-Eigenschaften ersetzen möchten, verwenden Sie stattdessen die with() Methode.

Syntax

js
withPlainTime()
withPlainTime(plainTime)

Parameter

plainTime Optional

Ein String, ein Objekt oder eine Temporal.PlainTime Instanz, die die neue Zeit repräsentiert. Sie wird zu einem Temporal.PlainTime Objekt konvertiert, wobei derselbe Algorithmus wie bei Temporal.PlainTime.from() verwendet wird. Falls nicht angegeben, wird der Zeitteil auf den Beginn des Tages gesetzt (der normalerweise 00:00:00 ist, es sei denn, er existiert nicht aufgrund von Versatzübergängen). Die Disambiguation erfolgt immer im Modus "compatible"; möchten Sie einen anderen Modus verwenden, verwenden Sie stattdessen die with() Methode.

Rückgabewert

Ein neues Temporal.ZonedDateTime Objekt, mit dem Datumsteil und der Zeitzone vom ursprünglichen Datum-Uhrzeit kopiert und dem Zeitteil durch die neue Zeit ersetzt.

Beispiele

Verwendung von withPlainTime()

js
const zdt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56[America/New_York]",
);

// You can pass a string
const newZDT = zdt.withPlainTime("13:45:00");
console.log(newZDT.toString()); // "2021-07-01T13:45:00-04:00[America/New_York]"

// 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 newZDT2 = zdt.withPlainTime({ hour: 13 });
console.log(newZDT2.toString()); // "2021-07-01T13:00:00-04:00[America/New_York]"

// You can pass nothing to set the time to midnight
const newZDT3 = zdt.withPlainTime();
console.log(newZDT3.toString()); // "2021-07-01T00:00:00-04:00[America/New_York]"

// But, if midnight doesn't exist, it may be a different time
const zdt2 = Temporal.ZonedDateTime.from(
  "2015-10-18T12:00-02:00[America/Sao_Paulo]",
);
console.log(zdt2.withPlainTime().toString()); // "2015-10-18T01:00:00-02:00[America/Sao_Paulo]"

Spezifikationen

Specification
Temporal
# sec-temporal.zoneddatetime.prototype.withplaintime

Browser-Kompatibilität

Siehe auch