Temporal.Instant.fromEpochNanoseconds()

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.fromEpochNanoseconds() erstellt ein neues Temporal.Instant-Objekt basierend auf der Anzahl der Nanosekunden seit der Unix-Epoche (Mitternacht zu Beginn des 1. Januars 1970, UTC).

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

Syntax

js
Temporal.Instant.fromEpochNanoseconds(epochNanoseconds)

Parameter

epochNanoseconds

Ein BigInt, das die Anzahl der Nanosekunden seit der Unix-Epoche repräsentiert.

Rückgabewert

Ein neues Temporal.Instant-Objekt, das den durch epochNanoseconds angegebenen Zeitpunkt darstellt.

Ausnahmen

RangeError

Wird ausgelöst, wenn epochNanoseconds nicht im darstellbaren Bereich liegt, der ±108 Tage oder etwa ±273.972,6 Jahre von der Unix-Epoche umfasst.

Beispiele

Verwendung von Temporal.Instant.fromEpochNanoseconds()

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

Spezifikationen

Specification
Temporal proposal
# sec-temporal.instant.fromepochnanoseconds

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch