Temporal.ZonedDateTime.prototype.epochNanoseconds
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die epochNanoseconds-Zugriffseigenschaft von Temporal.ZonedDateTime-Instanzen gibt ein BigInt zurück, das die Anzahl der Nanosekunden darstellt, die seit dem Unix-Epoch (Mitternacht zu Beginn des 1. Januar 1970, UTC) bis zu diesem Moment vergangen sind.
Der Set-Accessor von epochNanoseconds ist undefined. Sie können diese Eigenschaft nicht direkt ändern. Um ein neues Temporal.ZonedDateTime-Objekt mit dem gewünschten neuen epochNanoseconds-Wert zu erstellen, verwenden Sie stattdessen den new Temporal.ZonedDateTime()-Konstruktor.
Ein Zeitpunkt kann nur ±108 Tage (etwa ±273.972,6 Jahre) um die Epoche herum darstellen, was ±8,64e21 Nanosekunden entspricht. Der Versuch, epochNanoseconds über diesen Grenzwert hinaus festzulegen, führt zu einem RangeError.
Beispiele
Verwendung von epochNanoseconds
const zdt = Temporal.ZonedDateTime.from("2021-08-01T12:34:56.789Z[UTC]");
console.log(zdt.epochNanoseconds); // 1627821296789000000n
const zdt2 = Temporal.ZonedDateTime.from("1969-08-01T12:34:56.789Z[UTC]");
console.log(zdt2.epochNanoseconds); // -13173903211000000n
Erstellen eines ZonedDateTime-Objekts aus einem epochNanoseconds-Wert
Sie können ein Temporal.ZonedDateTime-Objekt aus einem epochNanoseconds-Wert unter Verwendung des Temporal.ZonedDateTime()-Konstruktors erstellen.
const epochNanoseconds = 1627821296789000000n;
const zdt = new Temporal.ZonedDateTime(epochNanoseconds, "UTC");
console.log(zdt.toString()); // 2021-08-01T12:34:56.789+00:00[UTC]
Spezifikationen
| Spezifikation |
|---|
| Temporal # sec-get-temporal.zoneddatetime.prototype.epochnanoseconds |