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 aus der Anzahl der Nanosekunden seit dem Unix-Epoch (Mitternacht am Anfang 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.fromEpochNanoseconds(epochNanoseconds)

Parameter

epochNanoseconds

Ein BigInt, der die Anzahl der Nanosekunden seit dem Unix-Epoch darstellt.

Rückgabewert

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

Ausnahmen

RangeError

Wird ausgelöst, wenn epochNanoseconds außerhalb des Bereichs eines darstellbaren Zeitpunkts liegt, was ±108 Tage (±8.64e21 Nanosekunden oder etwa ±273,972.6 Jahre) 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