Date : méthode toTemporalInstant()
Limited availability
Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.
La méthode toTemporalInstant() des instances de Date retourne un nouvel objet Temporal.Instant avec les même valeurs en epochMilliseconds que la date timestamp.
Utilisez cette méthode pour convertir des valeurs Date héritées en objets de l'API Temporal, puis convertissez-les en d'autres classes Temporal si nécessaire.
Syntaxe
js
toTemporalInstant()
Paramètres
Aucun.
Valeur de retour
Un nouvel objet Temporal.Instant ayant la même valeur de epochMilliseconds que l'horodatage de cette date. Ses composantes microsecondes et nanosecondes sont toujours 0.
Exceptions
RangeError-
Levée si la date est invalide (son horodatage est
NaN).
Exemples
Utiliser la méthode toTemporalInstant()
js
const dateHeritee = new Date("2021-07-01T12:34:56.789Z");
const instant = dateHeritee.toTemporalInstant();
// Convertir ensuite en d'autres objets
const zdt = instant.toZonedDateTimeISO("UTC");
const date = zdt.toPlainDate();
console.log(date.toString()); // 2021-07-01
Spécifications
| Specification |
|---|
| Temporal # sec-date.prototype.totemporalinstant |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.Instant - L'objet
Temporal.ZonedDateTime - La méthode
Temporal.Instant.fromEpochMilliseconds()