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
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()
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 |