Temporal.ZonedDateTime.prototype.toPlainDateTime()

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 toPlainDateTime()-Methode von Instanzen von Temporal.ZonedDateTime gibt ein neues Temporal.PlainDateTime-Objekt zurück, das die Datums- und Uhrzeitanteile dieses Date-Times darstellt. Nur die Zeitzoneninformation wird entfernt.

Warnung: Nachdem ein Temporal.ZonedDateTime in Temporal.PlainDateTime umgewandelt wurde, ist es nicht mehr zeitzonenbewusst. Nachfolgende Operationen wie Arithmetik oder with()-Operationen werden nicht für die Sommerzeit (DST) angepasst und könnten nicht die gleichen Ergebnisse liefern wie gleichwertige Operationen mit dem ursprünglichen Temporal.ZonedDateTime. Es sei denn, Sie führen diese Operationen über einen Zeitzonenoffset-Übergang hinweg durch, dann wird der Unterschied erkennbar. Seien Sie daher sehr vorsichtig bei dieser Umwandlung, da nachfolgende Ergebnisse die meiste Zeit korrekt sein können, aber nur dann falsch ausfallen, wenn Sie über Offset-Übergänge wie den Beginn oder das Ende der Sommerzeit hinausgehen.

Syntax

js
toPlainDateTime()

Parameter

Keine.

Rückgabewert

Ein neues Temporal.PlainDateTime-Objekt, das die Datums- und Uhrzeitanteile dieses Date-Times darstellt.

Beispiele

Verwendung von toPlainDateTime()

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

Spezifikationen

Specification
Temporal proposal
# sec-temporal.zoneddatetime.prototype.toplaindatetime

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch