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.

Die toTemporalInstant() Methode von Date Instanzen gibt ein neues Temporal.Instant Objekt mit demselben epochMilliseconds Wert wie der Zeitstempel dieses Datums zurück.

Verwenden Sie diese Methode, um alte Date-Werte in die Temporal-API zu konvertieren und dann nach Bedarf weiter in andere Temporal Klassen umzuwandeln.

Syntax

js
toTemporalInstant()

Parameter

Keine.

Rückgabewert

Ein neues Temporal.Instant Objekt mit demselben 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