Date.prototype.toTemporalInstant()

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 toTemporalInstant() Methode von Date Instanzen gibt ein neues Temporal.Instant Objekt mit dem gleichen epochMilliseconds Wert wie der Zeitstempel dieses Datums zurück.

Verwenden Sie diese Methode, um veraltete Date Werte in die Temporal API zu konvertieren und anschließend nach Bedarf weiter in andere Temporal Klassen zu konvertieren.

Syntax

js
toTemporalInstant()

Parameter

Keine.

Rückgabewert

Ein neues Temporal.Instant Objekt mit dem gleichen epochMilliseconds Wert wie der Zeitstempel dieses Datums. Seine Mikrosekunden- und Nanosekundenkomponenten sind immer 0.

Ausnahmen

RangeError

Wird ausgelöst, wenn das Datum ungültig ist (es hat einen Zeitstempel von NaN).

Beispiele

Verwendung von toTemporalInstant()

js
const legacyDate = new Date("2021-07-01T12:34:56.789Z");
const instant = legacyDate.toTemporalInstant();

// Further convert it to other objects
const zdt = instant.toZonedDateTimeISO("UTC");
const date = zdt.toPlainDate();
console.log(date.toString()); // 2021-07-01

Spezifikationen

Specification
Temporal
# sec-date.prototype.totemporalinstant

Browser-Kompatibilität

Siehe auch