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 fromEpochNanoseconds()

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 fromEpochNanoseconds() des instances de Temporal.Instant crée un nouvel objet Temporal.Instant à partir du nombre de nanosecondes é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.fromEpochNanoseconds(epochNanoseconds)

Paramètres

epochNanoseconds

Un objet BigInt représentant le nombre de nanosecondes écoulées depuis l'époque Unix.

Valeur de retour

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

Exceptions

RangeError

Levée si epochNanoseconds 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 fromEpochNanoseconds()

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

Spécifications

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

Compatibilité des navigateurs

Voir aussi