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 Datums-Zeit Objekts darstellt.

Warnung: Nachdem ein Temporal.ZonedDateTime zu Temporal.PlainTime konvertiert wurde, ist es nicht mehr auf die Zeitzone bezogen. Nachfolgende Operationen wie Arithmetik oder with() Operationen werden nicht für Sommerzeit (DST) angepasst und könnten nicht die gleichen Ergebnisse liefern wie äquivalente Operationen mit dem ursprünglichen Temporal.ZonedDateTime. Es ist jedoch unmöglich, den Unterschied zu bemerken, es sei denn, Sie führen diese Operationen über eine Zeitzonen-Offset-Übergang durch. Seien Sie daher sehr vorsichtig bei dieser Umwandlung, da nachfolgende Ergebnisse die meiste Zeit korrekt sein könnten, jedoch nur dann falsch sein könnten, wenn Sie über Offset-Übergänge wie den Beginn oder das Ende der Sommerzeit gehen.

Syntax

js
toPlainTime()

Parameter

Keine.

Rückgabewert

Ein neues Temporal.PlainTime Objekt, das den Zeitanteil dieses Datums-Zeit Objekts 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 proposal
# sec-temporal.zoneddatetime.prototype.toplaintime

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch