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

Diese Methode ersetzt alle Zeiteigenschaften und setzt sie auf 0, wenn nicht anders angegeben. Wenn Sie nur einige der Zeiteigenschaften ersetzen möchten, verwenden Sie stattdessen die with() Methode.

Syntax

withPlainTime()
withPlainTime(plainTime)

Parameter

plainTime Optional: Eine Zeichenkette, ein Objekt oder eine Temporal.PlainTime Instanz, die die neue Zeit repräsentiert. Sie wird in ein Temporal.PlainTime Objekt umgewandelt unter Verwendung desselben Algorithmus wie Temporal.PlainTime.from(). Falls nicht angegeben, wird der Zeitanteil auf den Beginn des Tages gesetzt (was normalerweise 00:00:00 ist, es sei denn, er existiert nicht aufgrund von Offset-Übergängen). Disambiguierung erfolgt immer im "compatible" Modus; wenn Sie einen anderen Modus verwenden möchten, verwenden Sie stattdessen die with() Methode.

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]"