Temporal.Instant()

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.

Der Temporal.Instant() Konstruktor erstellt Temporal.Instant Objekte.

Dieser Konstruktor ist genau äquivalent zum Aufruf von Temporal.Instant.fromEpochNanoseconds().

Syntax

js
new Temporal.Instant(epochNanoseconds)

Hinweis: Temporal.Instant() kann nur mit new konstruiert werden. Ein Versuch, es ohne new aufzurufen, führt zu einem TypeError.

Parameter

epochNanoseconds

Ein BigInt, das die Anzahl der Nanosekunden seit der Unix-Epoche darstellt.

Rückgabewert

Ein neues Temporal.Instant Objekt, das den Zeitpunkt darstellt, der durch epochNanoseconds festgelegt wird.

Ausnahmen

RangeError

Wird geworfen, wenn epochNanoseconds einen Zeitpunkt außerhalb des Bereichs darstellbarer Zeitpunkte repräsentiert, welcher ±108 Tage oder etwa ±273.972,6 Jahre von der Unix-Epoche entfernt ist.

Beispiele

Verwendung von Temporal.Instant()

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

Spezifikationen

Specification
Temporal proposal
# sec-temporal-instant-constructor

Browser-Kompatibilität

Siehe auch