Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

Temporal.Instant : méthode statique fromEpochMilliseconds()

Disponibilité limitée

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

La méthode statique fromEpochMilliseconds() des instances de Temporal.Instant crée un nouvel objet Temporal.Instant à partir du nombre de millisecondes écoulées depuis l'époque Unix (minuit au début du 1er janvier 1970, UTC).

Pour convertir un objet Date en un objet Temporal.Instant, utilisez plutôt Date.prototype.toTemporalInstant().

Syntaxe

js
Temporal.Instant.fromEpochMilliseconds(epochMilliseconds)

Paramètres

epochMilliseconds

Un nombre représentant le nombre de millisecondes écoulées depuis l'époque Unix. En interne, il est converti en BigInt et multiplié par 1e6 pour obtenir le nombre de nanosecondes.

Valeur de retour

Un nouvel objet Temporal.Instant représentant l'instant dans le temps défini par epochMilliseconds.

Exceptions

RangeError

Levée dans l'un des cas suivants :

  • epochMilliseconds ne peut pas être converti en BigInt (par exemple, ce n'est pas un entier).
  • epochMilliseconds n'est pas dans la plage représentable, qui est de ±108 jours, soit environ ±273 972,6 ans, à partir de l'époque Unix.

Exemples

Utiliser la méthode fromEpochMilliseconds()

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

Spécifications

Spécification
Temporal
# sec-temporal.instant.fromepochmilliseconds

Compatibilité des navigateurs

Voir aussi