Temporal.ZonedDateTime : propriété epochNanoseconds

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

La propriété d'accesseur epochNanoseconds des instances de Temporal.ZonedDateTime retourne un grand entier (BigInt) représentant le nombre de nanosecondes écoulées depuis l'époque Unix (minuit au début du 1er janvier 1970, UTC) jusqu'à cet instant.

Le mutateur d'accesseur de epochNanoseconds est undefined. Vous ne pouvez pas modifier cette propriété directement. Pour créer un nouvel objet Temporal.ZonedDateTime avec la nouvelle valeur souhaitée de epochNanoseconds, utilisez le constructeur new Temporal.ZonedDateTime() à la place.

Un instant ne peut représenter que ±10⁸ jours (environ ±273 972,6 ans) autour de l'époque, soit ±8,64e21 nanosecondes. Tenter de définir epochNanoseconds au-delà de cette limite déclenche une RangeError.

Exemples

Utiliser la propriété `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

Créer un objet `ZonedDateTime` à partir d'une valeur `epochNanoseconds`

Vous pouvez créer un objet Temporal.ZonedDateTime à partir d'une valeur epochNanoseconds en utilisant le constructeur Temporal.ZonedDateTime().

const epochNanoseconds = 1627821296789000000n;
const zdt = new Temporal.ZonedDateTime(epochNanoseconds, "UTC");
console.log(zdt.toString()); // 2021-08-01T12:34:56.789+00:00[UTC]