Date.prototype.toTemporalInstant()
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
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()
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
BCD tables only load in the browser