Temporal.Now

Disponibilité limitée

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

L'objet Temporal.Now d'espace de noms contient des méthodes statiques pour obtenir l'heure actuelle dans différents formats.

Description

Contrairement à la plupart des objets universels, Temporal.Now n'est pas un constructeur. Vous ne pouvez pas l'utiliser avec l'opérateur new ni invoquer l'objet Temporal.Now comme une fonction. Toutes les propriétés et méthodes de Temporal.Now sont statiques (tout comme l'objet Math).

Fondamentalement, l'heure système est retournée par le système d'exploitation comme un temps écoulé depuis l'époque Unix (généralement avec une précision au milliseconde, mais pouvant également être au nanoseconde). Temporal.Now.instant() retourne ce temps sous forme d'objet Temporal.Instant.

Un instant peut être interprété dans un fuseau horaire (qui est le fuseau horaire système Temporal.Now.timeZoneId() par défaut) de la même manière que Temporal.Instant.prototype.toZonedDateTimeISO(). Pour obtenir un objet Temporal.ZonedDateTime, vous pouvez utiliser Temporal.Now.zonedDateTimeISO(). Vous pouvez également obtenir différentes parties de la date et de l'heure, en utilisant Temporal.Now.plainDateISO(), Temporal.Now.plainTimeISO() et Temporal.Now.plainDateTimeISO().

Par exemple, si l'ordinateur est réglé sur le fuseau horaire « America/New_York », Temporal.Now.zonedDateTimeISO() retourne une date-heure zonée comme : 2021-08-01T10:40:12.345-04:00[America/New_York]. Dans ce cas, Temporal.Now.plainTimeISO() retourne la partie temps de cette date-heure zonée : 10:40:12.345. Cependant, si vous appelez Temporal.Now.plainTimeISO("UTC"), cela retourne la partie temps de la date-heure zonée dans le fuseau horaire UTC : 14:40:12.345. Cela est particulièrement utile pour la communication entre systèmes où l'autre extrémité peut s'attendre à l'heure dans un fuseau horaire différent.

Réduire la précision temporelle

Pour offrir une protection contre les attaques par analyse temporelle et contre l'empreinte numérique, la précision des fonctions de Temporal.Now peut être arrondie selon les paramètres du navigateur. Dans Firefox, la préférence privacy.reduceTimerPrecision est activée par défaut et sa valeur par défaut est de 2ms. Vous pouvez aussi activer privacy.resistFingerprinting, auquel cas la précision sera de 100ms ou la valeur de privacy.resistFingerprinting.reduceTimerPrecision.microseconds, la plus grande des deux.

Par exemple, avec une précision temporelle réduite, le résultat de Temporal.Now.instant().epochMilliseconds sera toujours un multiple de 2, ou un multiple de 100 (ou de privacy.resistFingerprinting.reduceTimerPrecision.microseconds) lorsque privacy.resistFingerprinting est activé.

// précision temporelle réduite (2ms) dans Firefox 60
Temporal.Now.instant().epochMilliseconds;
// Might be:
// 1519211809934
// 1519211810362
// 1519211811670
// …

// précision temporelle réduite avec `privacy.resistFingerprinting` activé
Temporal.Now.instant().epochMilliseconds;
// Might be:
// 1519129853500
// 1519129858900
// 1519129864400
// …

Propriétés statiques

Temporal.Now[Symbol.toStringTag]: La valeur initiale de la propriété [Symbol.toStringTag] est la chaîne de caractères "Temporal.Now". Cette propriété est utilisée dans Object.prototype.toString().

Méthodes statiques

Temporal.Now.instant(): Retourne l'heure actuelle sous forme d'objet Temporal.Instant.
Temporal.Now.plainDateISO(): Retourne la date actuelle sous forme d'objet Temporal.PlainDate, dans le calendrier ISO 8601 et le fuseau horaire défini.
Temporal.Now.plainDateTimeISO(): Retourne la date et l'heure actuelles sous forme d'objet Temporal.PlainDateTime, dans le calendrier ISO 8601 et le fuseau horaire défini.
Temporal.Now.plainTimeISO(): Retourne l'heure actuelle sous forme d'objet Temporal.PlainTime, dans le fuseau horaire défini.
Temporal.Now.timeZoneId(): Retourne un identifiant de fuseau horaire représentant le fuseau horaire actuel du système.
Temporal.Now.zonedDateTimeISO(): Retourne la date et l'heure actuelles sous forme d'objet Temporal.ZonedDateTime, dans le calendrier ISO 8601 et le fuseau horaire défini.

Spécifications

Spécification
Temporal # sec-temporal-now-object

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN

Apprendre à contribuer

Cette page a été modifiée le 25 mars 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu