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 bei Bedarf 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 Nanosekunden-Komponenten 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 proposal
# sec-date.prototype.totemporalinstant

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
toTemporalInstant
Experimental

Legend

Tip: you can click/tap on a cell for more information.

In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.

Siehe auch