Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 dann bei Bedarf weiter in andere Temporal-Klassen umzuwandeln.

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