Temporal.Now

Description

Contrairement la plupart des objets universels, Temporal.Now n'est pas un constructeur. Vous ne pouvez pas l'utiliser avec l'oprateur new ni invoquer l'objet Temporal.Now comme une fonction. Toutes les proprits et mthodes de Temporal.Now sont statiques (tout comme l'objet Math).

Fondamentalement, l'heure systme est retourne par le systme d'exploitation comme un temps coul depuis l'poque Unix (gnralement avec une prcision au milliseconde, mais pouvant galement tre au nanoseconde). Temporal.Now.instant() retourne ce temps sous forme d'objet Temporal.Instant.

Un instant peut tre interprt dans un fuseau horaire (qui est le fuseau horaire systme Temporal.Now.timeZoneId() par dfaut) de la mme manire que Temporal.Instant.prototype.toZonedDateTimeISO(). Pour obtenir un objet Temporal.ZonedDateTime, vous pouvez utiliser Temporal.Now.zonedDateTimeISO(). Vous pouvez galement obtenir diffrentes 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 rgl sur le fuseau horaire  America/New_York , Temporal.Now.zonedDateTimeISO() retourne une date-heure zone 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 zone : 10:40:12.345. Cependant, si vous appelez Temporal.Now.plainTimeISO("UTC"), cela retourne la partie temps de la date-heure zone dans le fuseau horaire UTC : 14:40:12.345. Cela est particulirement utile pour la communication entre systmes o l'autre extrmit peut s'attendre l'heure dans un fuseau horaire diffrent.

Rduire la prcision temporelle

Pour offrir une protection contre les attaques par analyse temporelle et contre l'empreinte numrique, la prcision des fonctions de Temporal.Now peut tre arrondie selon les paramtres du navigateur. Dans Firefox, la prfrence privacy.reduceTimerPrecision est active par dfaut et sa valeur par dfaut est de 2ms. Vous pouvez aussi activer privacy.resistFingerprinting, auquel cas la prcision sera de 100ms ou la valeur de privacy.resistFingerprinting.reduceTimerPrecision.microseconds, la plus grande des deux.

Par exemple, avec une prcision temporelle rduite, le rsultat 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.

// prcision temporelle rduite (2ms) dans Firefox 60
Temporal.Now.instant().epochMilliseconds;
// Might be:
// 1519211809934
// 1519211810362
// 1519211811670
// 

// prcision temporelle rduite avec `privacy.resistFingerprinting` activ
Temporal.Now.instant().epochMilliseconds;
// Might be:
// 1519129853500
// 1519129858900
// 1519129864400
// 

Proprits statiques

Temporal.Now[Symbol.toStringTag]

La valeur initiale de la proprit [Symbol.toStringTag] est la chane de caractres "Temporal.Now". Cette proprit est utilise dans Object.prototype.toString().

Mthodes 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 dfini.

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 dfini.

Temporal.Now.plainTimeISO()

Retourne l'heure actuelle sous forme d'objet Temporal.PlainTime, dans le fuseau horaire dfini.

Temporal.Now.timeZoneId()

Retourne un identifiant de fuseau horaire reprsentant le fuseau horaire actuel du systme.

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 dfini.

Spcifications

Compatibilit des navigateurs

Voir aussi

• L'objet Temporal
• L'objet Temporal.Instant
• L'objet Temporal.PlainDate
• L'objet Temporal.PlainDateTime
• L'objet Temporal.PlainTime
• L'objet Temporal.ZonedDateTime