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-Datum mit dem neuen Zeitteil vollständig ersetzt (in einer Form, die durch Temporal.PlainTime.from() konvertierbar ist).
Diese Methode ersetzt alle Zeit-Eigenschaften und setzt nicht angegebene Eigenschaften standardmäßig auf 0. Wenn Sie nur einige der Zeit-Eigenschaften ersetzen möchten, verwenden Sie stattdessen die with() Methode.
Syntax
withPlainTime()
withPlainTime(plainTime)
Parameter
plainTimeOptional-
Ein String, ein Objekt oder eine
Temporal.PlainTimeInstanz, die die neue Zeit repräsentiert. Diese wird mithilfe desselben Algorithmus zu einemTemporal.PlainTimeObjekt konvertiert wieTemporal.PlainTime.from(). Falls nicht angegeben, wird der Zeitteil auf den Anfang des Tages gesetzt (was normalerweise00:00:00ist, es sei denn, er existiert aufgrund von Offset-Übergängen nicht). Disambiguierung erfolgt immer im Modus"compatible"; wenn Sie einen anderen Modus verwenden möchten, nutzen Sie stattdessen diewith()Methode.
Rückgabewert
Ein neues Temporal.ZonedDateTime Objekt, mit dem Datumsabschnitt und der Zeitzone vom ursprünglichen Datum-Uhrzeit-Datum kopiert und dem Zeitteil durch die neue Zeit ersetzt.
Beispiele
Verwendung von withPlainTime()
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
Loading…