Temporal.Instant.fromEpochMilliseconds()

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 statische Methode Temporal.Instant.fromEpochMilliseconds() erstellt ein neues Temporal.Instant-Objekt aus der Anzahl der Millisekunden seit der Unix-Epoche (Mitternacht zu Beginn des 1. Januar 1970, UTC).

Um ein Date-Objekt in ein Temporal.Instant-Objekt zu konvertieren, verwenden Sie stattdessen Date.prototype.toTemporalInstant().

Syntax

js
Temporal.Instant.fromEpochMilliseconds(epochMilliseconds)

Parameter

epochMilliseconds

Eine Zahl, die die Anzahl der Millisekunden seit der Unix-Epoche darstellt. Intern wird diese in ein BigInt konvertiert und mit 1e6 multipliziert, um die Anzahl der Nanosekunden zu erhalten.

Rückgabewert

Ein neues Temporal.Instant-Objekt, das den Zeitpunkt darstellt, der durch epochMilliseconds angegeben wird.

Ausnahmen

RangeError

Wird ausgelöst, wenn epochMilliseconds außerhalb des Bereichs eines darstellbaren Zeitpunkts liegt, welcher ±108 Tage (±8.64e15 Millisekunden oder etwa ±273.972,6 Jahre) beträgt, oder wenn es nicht in ein BigInt konvertiert werden kann (z.B. keine ganze Zahl).

Beispiele

Verwendung von Temporal.Instant.fromEpochMilliseconds()

js
const instant = Temporal.Instant.fromEpochMilliseconds(0);
console.log(instant.toString()); // 1970-01-01T00:00:00Z
const vostok1Liftoff = Temporal.Instant.fromEpochMilliseconds(-275248380000);
console.log(vostok1Liftoff.toString()); // 1961-04-12T06:07:00Z
const sts1Liftoff = Temporal.Instant.fromEpochMilliseconds(355924804000);
console.log(sts1Liftoff.toString()); // 1981-04-12T12:00:04Z

Spezifikationen

Specification
Temporal proposal
# sec-temporal.instant.fromepochmilliseconds

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch