Temporal.ZonedDateTime.prototype.toPlainTime()

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 toPlainTime()-Methode von Temporal.ZonedDateTime Instanzen gibt ein neues Temporal.PlainTime-Objekt zurück, das den Zeitanteil dieses Datum-Zeit-Wertes darstellt.

Warnung: Nachdem ein Temporal.ZonedDateTime in Temporal.PlainTime umgewandelt wurde, ist es nicht mehr zeitzonenbewusst. Nachfolgende Operationen wie Arithmetik oder with()-Operationen werden nicht an DST angepasst und können möglicherweise nicht die gleichen Ergebnisse liefern wie äquivalente Operationen mit dem ursprünglichen Temporal.ZonedDateTime. Wenn Sie jedoch diese Operationen nicht über einen Zeitzonenoffset-Übergang hinweg durchführen, ist es unmöglich, den Unterschied zu bemerken. Daher sollten Sie bei dieser Umwandlung sehr vorsichtig sein, da nachfolgende Ergebnisse meist korrekt sein können, aber nur dann inkorrekt erscheinen, wenn man über Offset-Übergänge wie den Beginn oder das Ende der Sommerzeit hinweggeht.

Syntax

js
toPlainTime()

Parameter

Keine.

Rückgabewert

Ein neues Temporal.PlainTime-Objekt, das den Zeitanteil dieses Datum-Zeit-Wertes darstellt.

Beispiele

Verwendung von toPlainTime()

js
const zdt = Temporal.ZonedDateTime.from(
  "2021-07-01T12:34:56.987654321-04:00[America/New_York]",
);
const plainTime = zdt.toPlainTime();
console.log(plainTime.toString()); // 12:34:56.987654321

Spezifikationen

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

Browser-Kompatibilität

Siehe auch