Temporal.ZonedDateTime : propriété epochMilliseconds

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 epochMilliseconds des instances de Temporal.ZonedDateTime retourne un entier représentant le nombre de millisecondes écoulées depuis l'époque Unix (minuit au début du 1er janvier 1970, UTC) jusqu'à cet instant. Elle est équivalente à la division de epochNanoseconds par 1e6 et à l'arrondi inférieur du résultat.

Le mutateur d'accesseur de epochMilliseconds 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 epochMilliseconds, voir ci-dessous.

Exemples

Utiliser la propriété `epochMilliseconds`

const zdt = Temporal.ZonedDateTime.from("2021-08-01T12:34:56.789Z[UTC]");
console.log(zdt.epochMilliseconds); // 1627821296789

const zdt2 = Temporal.ZonedDateTime.from("1969-08-01T12:34:56.789Z[UTC]");
console.log(zdt2.epochMilliseconds); // -13173903211

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

Vous pouvez créer un objet Temporal.ZonedDateTime à partir d'une valeur epochMilliseconds en construisant d'abord un objet Temporal.Instant à l'aide de Temporal.Instant.fromEpochMilliseconds(), puis en le convertissant en un objet Temporal.ZonedDateTime à l'aide de Temporal.Instant.prototype.toZonedDateTimeISO() :

const epochMilliseconds = 1627821296789;
const instant = Temporal.Instant.fromEpochMilliseconds(epochMilliseconds);
const zdt = instant.toZonedDateTimeISO("UTC");
console.log(zdt.toString()); // 2021-08-01T12:34:56.789+00:00[UTC]

Vous pouvez également utiliser le constructeur Temporal.ZonedDateTime(), mais convertissez d'abord les millisecondes en nanosecondes :

const epochMilliseconds = 1627821296789;
const epochNanoseconds = BigInt(epochMilliseconds) * 1_000_000n;
const zdt = new Temporal.ZonedDateTime(epochNanoseconds, "UTC");
console.log(zdt.toString()); // 2021-08-01T12:34:56.789+00:00[UTC]