Temporal.Instant

Description

Temporal.Instant est smantiquement identique Date. Les deux encapsulent un point unique dans le temps, mais Temporal.Instant est plus prcis car il stocke les nanosecondes plutt que les millisecondes. Temporal.Instant vite galement les piges de Date car il ne suppose aucune information de calendrier ou de fuseau horairesi vous souhaitez lire des informations de date ou d'heure telles que l'anne ou le mois, vous devez d'abord le convertir en Temporal.ZonedDateTime, en utilisant toZonedDateTimeISO().

Vous pouvez convertir un objet Date en Temporal.Instant en utilisant la mthode Date.prototype.toTemporalInstant(), qui doit tre prfre d'autres mthodes telles que Temporal.Instant.fromEpochMilliseconds() car elle implique moins de code utilisateurice et peut tre plus optimise. Vous pouvez galement convertir un Temporal.Instant en Date en utilisant ses millisecondes depuis l'poque, par exemple new Date(instant.epochMilliseconds).

Format RFC 9557

Les objets Instant peuvent tre srialiss et analyss en utilisant le format RFC 9557 (angl.), une extension du format ISO 8601 / RFC 3339 (angl.). La chane de caractres a la forme suivante (les espaces sont uniquement pour la lisibilit et ne doivent pas tre prsents dans la chane de caractres relle) :

YYYY-MM-DD T HH:mm:ss.sssssssss Z/HH:mm

YYYY

Soit un nombre quatre chiffres, soit un nombre six chiffres avec un signe + ou -.

MM

Un nombre deux chiffres de 01 12.

DD

Un nombre deux chiffres de 01 31. Les composants YYYY, MM et DD peuvent tre spars par - ou rien.

T

Le sparateur date-heure, qui peut tre T, t ou un espace.

HH

Un nombre deux chiffres de 00 23.

mm Facultatif

Un nombre deux chiffres de 00 59. Par dfaut 00.

ss.sssssssss Facultatif

Un nombre deux chiffres de 00 59. Peut tre suivi optionnellement par un . ou , et un neuf chiffres. Par dfaut 00. Les composants HH, mm et ss peuvent tre spars par : ou rien. Vous pouvez omettre soit ss seul, soit ss et mm, donc l'heure peut tre sous trois formes : HH, HH:mm ou HH:mm:ss.sssssssss.

Z/HH:mm

Soit le dsignateur UTC Z ou z, soit un dcalage par rapport l'UTC sous la forme + ou - suivi du mme format que le composant horaire. Notez que la prcision subminute (:ss.sssssssss) peut ne pas tre prise en charge par d'autres systmes, et est accepte mais jamais affiche. Si un dcalage est fourni, l'heure est interprte dans le dcalage dfini.

En entre, vous pouvez ventuellement inclure l'identifiant de fuseau horaire et le calendrier, dans le mme format que ZonedDateTime, mais ils seront ignors. D'autres annotations au format [key=value] sont galement ignores, et elles ne doivent pas avoir le drapeau critique.

Lors de la srialisation, vous pouvez configurer les chiffres fractionnaires des secondes et le dcalage.

Constructeur

Temporal.Instant()

Cre un nouvel objet Temporal.Instant en fournissant directement les donnes sous-jacentes.

Mthodes statiques

Temporal.Instant.compare()

Retourne un nombre (-1, 0 ou 1) indiquant si le premier instant prcde, est identique ou suit le deuxime instant. quivaut comparer les epochNanoseconds des deux instants.

Temporal.Instant.from()

Cre un nouvel objet Temporal.Instant partir d'un autre objet Temporal.Instant ou d'une chane de caractres au format RFC 9557.

Temporal.Instant.fromEpochMilliseconds()

Cre un nouvel objet Temporal.Instant partir du nombre de millisecondes coules depuis l'poque Unix (minuit au dbut du 1er janvier 1970, UTC).

Temporal.Instant.fromEpochNanoseconds()

Cre un nouvel objet Temporal.Instant partir du nombre de nanosecondes coules depuis l'poque Unix (minuit au dbut du 1er janvier 1970, UTC).

Proprits d'instance

Ces proprits sont dfinies sur Temporal.Instant.prototype et partages par toutes les instances de Temporal.Instant.

Temporal.Instant.prototype.constructor

La fonction constructeur qui a cr l'objet instance. Pour les instances de Temporal.Instant, la valeur initiale est le constructeur Temporal.Instant().

Temporal.Instant.prototype.epochMilliseconds

Retourne un entier reprsentant le nombre de millisecondes coules depuis l'poque Unix (minuit au dbut du 1er janvier 1970, UTC) jusqu' cet instant. quivaut diviser epochNanoseconds par 1e6 et arrondir l'entier infrieur.

Temporal.Instant.prototype.epochNanoseconds

Retourne un BigInt reprsentant le nombre de nanosecondes coules depuis l'poque Unix (minuit au dbut du 1er janvier 1970, UTC) jusqu' cet instant.

Temporal.Instant.prototype[Symbol.toStringTag]

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

Mthodes d'instance

Temporal.Instant.prototype.add()

Retourne un nouvel objet Temporal.Instant reprsentant cet instant avanc d'une dure donne (sous une forme convertible par Temporal.Duration.from()).

Temporal.Instant.prototype.equals()

Retourne true si cet instant est quivalent en valeur un autre instant (sous une forme convertible par Temporal.Instant.from()), et false sinon. Ils sont compars par leurs nanosecondes depuis l'poque. quivaut Temporal.Instant.compare(this, other) === 0.

Temporal.Instant.prototype.round()

Retourne un nouvel objet Temporal.Instant reprsentant cet instant arrondi l'unit donne.

Temporal.Instant.prototype.since()

Retourne un nouvel objet Temporal.Duration reprsentant la dure coule depuis un autre instant (sous une forme convertible par Temporal.Instant.from()) jusqu' cet instant. La dure est positive si l'autre instant est avant cet instant, et ngative si aprs.

Temporal.Instant.prototype.subtract()

Retourne un nouvel objet Temporal.Instant reprsentant cet instant recul d'une dure donne (sous une forme convertible par Temporal.Duration.from()).

Temporal.Instant.prototype.toJSON()

Retourne une chane de caractres reprsentant cet instant dans le mme format RFC 9557 que l'appel toString(). Destin tre appel implicitement par JSON.stringify().

Temporal.Instant.prototype.toLocaleString()

Retourne une chane de caractres reprsentant cet instant de manire sensible la langue. Dans les implmentations avec le support de l'API Intl.DateTimeFormat, cette mthode dlgue Intl.DateTimeFormat.

Temporal.Instant.prototype.toString()

Retourne une chane de caractres reprsentant cet instant dans le format RFC 9557 en utilisant le fuseau horaire dfini.

Temporal.Instant.prototype.toZonedDateTimeISO()

Retourne un nouvel objet Temporal.ZonedDateTime reprsentant cet instant dans le fuseau horaire dfini en utilisant le systme de calendrier ISO 8601.

Temporal.Instant.prototype.until()

Retourne un nouvel objet Temporal.Duration reprsentant la dure entre cet instant et un autre instant (sous une forme convertible par Temporal.Instant.from()). La dure est positive si l'autre instant est aprs cet instant, et ngative si avant.

Temporal.Instant.prototype.valueOf()

Lve un objet TypeError, ce qui empche les instances de Temporal.Instant d'tre converties implicitement en primitives lorsqu'elles sont utilises dans des oprations arithmtiques ou de comparaison.

Spcifications

Spcification
Temporal # sec-temporal-instant-objects

Compatibilit des navigateurs

Voir aussi

• L'objet Temporal
• L'objet Temporal.Duration
• L'objet Temporal.ZonedDateTime