Temporal.PlainDate

Disponibilit limite

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

Vous voulez une meilleure prise en charge pour cette fonctionnalit ? Dites-nous pourquoi.

En savoir plus
Voir la compatibilit complte

L'objet Temporal.PlainDate reprsente une date du calendrier (une date sans heure ni fuseau horaire) ; par exemple, un vnement sur un calendrier qui se produit pendant toute la journe, quel que soit le fuseau horaire. Il est fondamentalement reprsent comme une date du calendrier ISO 8601, avec des champs pour l'anne, le mois et le jour, et un systme de calendrier associ.

Description

Un objet PlainDate est essentiellement la partie date d'un objet Temporal.PlainDateTime, avec les informations de temps supprimes. Comme les informations de date et d'heure n'ont pas beaucoup d'interaction, toutes les informations gnrales sur les proprits de date sont documentes ici.

Format RFC 9557

Les objets PlainDate peuvent tre srialiss et analyss en utilisant le format RFC 9557 (ang.), une extension du format ISO 8601 / RFC 3339 (ang.). 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 [u-ca=calendar_id]

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.
[u-ca=calendar_id] Facultatif: Remplacez calendar_id par le calendrier utiliser. Voir Intl.supportedValuesOf() pour une liste des types de calendriers couramment pris en charge. Par dfaut, [u-ca=iso8601]. Peut avoir un drapeau critique en prfixant la cl avec ! : par exemple, [!u-ca=iso8601]. Ce drapeau indique gnralement aux autres systmes qu'il ne peut pas tre ignor s'ils ne le prennent pas en charge. L'analyseur Temporal gnre une erreur si les annotations contiennent deux annotations de calendrier ou plus et que l'une d'elles est critique. Notez que le YYYY-MM-DD est toujours interprt comme une date du calendrier ISO 8601, puis converti en calendrier dfini.

Comme entre, vous pouvez ventuellement inclure l'heure, le dcalage et l'identifiant du fuseau horaire, dans le mme format que PlainDateTime, mais ils sont ignors. Les autres annotations au format [cl=valeur] sont galement ignores et ne doivent pas avoir le drapeau critique.

Lors de la srialisation, vous pouvez configurer l'affichage de l'identifiant du calendrier et l'ajout d'un drapeau critique pour celui-ci.

Fixer les dates invalides

Les mthodes Temporal.PlainDate.from(), Temporal.PlainDate.prototype.with(), Temporal.PlainDate.prototype.add(), Temporal.PlainDate.prototype.subtract() et leurs homologues dans d'autres objets Temporal, permettent de construire des dates en utilisant des proprits spcifiques au calendrier. Les composants de la date peuvent tre hors de porte. Dans le calendrier ISO, il s'agit toujours d'un dpassement, comme le mois tant suprieur 12 ou le jour tant suprieur au nombre de jours, et le corriger ne consiste qu' limiter la valeur la valeur maximale autorise. Dans d'autres calendriers, le cas invalide peut tre plus complexe. Lors de l'utilisation de l'option overflow: "constrain", les dates invalides sont corriges pour devenir valides de la manire suivante :

Si le jour n'existe pas mais que le mois existe : choisissez le jour le plus proche dans le mme mois. S'il y a deux dates galement proches dans ce mois, choisissez la plus tardive.
Si le mois est un mois intercalaire qui n'existe pas dans l'anne : choisissez une autre date selon les conventions culturelles des utilisateurices de ce calendrier. Cela se traduit gnralement par le mme jour dans le mois prcdent ou suivant o ce mois tombe normalement dans une anne bissextile.
Si le mois n'existe pas dans l'anne pour d'autres raisons : choisissez la date la plus proche qui est encore dans la mme anne. S'il y a deux dates galement proches dans cette anne, choisissez la plus tardive.
Si l'anne entire n'existe pas : choisissez la date la plus proche dans une autre anne. S'il y a deux dates galement proches, choisissez la plus tardive.

Constructeur

Temporal.PlainDate(): Cre un nouvel objet Temporal.PlainDate en fournissant directement les donnes sous-jacentes.

Mthodes statiques

Temporal.PlainDate.compare(): Retourne un nombre (-1, 0 ou 1) indiquant si la premire date est antrieure, identique ou postrieure la deuxime date. quivaut comparer les champs anne, mois et jour des dates ISO 8601 sous-jacentes.
Temporal.PlainDate.from(): Cre un nouvel objet Temporal.PlainDate partir d'un autre objet Temporal.PlainDate, d'un objet avec des proprits de date ou d'une chane de caractres au format RFC 9557.

Proprits d'instance

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

Temporal.PlainDate.prototype.calendarId: Retourne une chane de caractres reprsentant le calendrier utilis pour interprter la date ISO 8601 interne.
Temporal.PlainDate.prototype.constructor: La fonction constructeur qui a cr l'objet instance. Pour les instances de Temporal.PlainDate, la valeur initiale est le constructeur Temporal.PlainDate().
Temporal.PlainDate.prototype.day: Retourne un entier positif reprsentant l'index du jour dans le mois de cette date, bas sur 1, ce qui correspond au numro de jour que vous voyez sur un calendrier. Dpend du calendrier. Gnralement commence 1 et est continu, mais pas toujours.
Temporal.PlainDate.prototype.dayOfWeek: Retourne un entier positif reprsentant l'index du jour dans la semaine de cette date, bas sur 1. Les jours de la semaine sont numrots squentiellement de 1 daysInWeek, chaque numro correspondant son nom. Dpend du calendrier. 1 reprsente gnralement le lundi dans le calendrier, mme lorsque les locales utilisant le calendrier peuvent considrer un autre jour comme le premier jour de la semaine (voir Intl.Locale.prototype.getWeekInfo()).
Temporal.PlainDate.prototype.dayOfYear: Retourne un entier positif reprsentant l'index du jour dans l'anne de cette date, bas sur 1. Le premier jour de cette anne est 1, et le dernier jour est le daysInYear. Dpend du calendrier.
Temporal.PlainDate.prototype.daysInMonth: Retourne un entier positif reprsentant le nombre de jours dans le mois de cette date. Dpend du calendrier.
Temporal.PlainDate.prototype.daysInWeek: Retourne un entier positif reprsentant le nombre de jours dans la semaine de cette date. Dpend du calendrier. Pour le calendrier ISO 8601, c'est toujours 7, mais dans d'autres systmes de calendrier, cela peut varier d'une semaine l'autre.
Temporal.PlainDate.prototype.daysInYear: Retourne un entier positif reprsentant le nombre de jours dans l'anne de cette date. Dpend du calendrier. Pour le calendrier ISO 8601, c'est 365, ou 366 dans une anne bissextile.
Temporal.PlainDate.prototype.era: Retourne une chane de caractres en minuscules spcifique au calendrier reprsentant l're de cette date, ou undefined si le calendrier n'utilise pas d'res (par exemple, ISO 8601). era et eraYear identifient ensemble de manire unique une anne dans un calendrier, de la mme manire que year. Dpend du calendrier. Pour le calendrier grgorien, c'est soit "ce", soit "bce".
Temporal.PlainDate.prototype.eraYear: Retourne un entier qui n'est pas ngatif reprsentant l'anne de cette date dans l're, ou undefined si le calendrier n'utilise pas d'res (par exemple, ISO 8601). L'index de l'anne commence gnralement 1 (plus courant) ou 0, et les annes dans une re peuvent diminuer avec le temps (par exemple, BCE grgorien). era et eraYear identifient ensemble de manire unique une anne dans un calendrier, de la mme manire que year. Dpend du calendrier.
Temporal.PlainDate.prototype.inLeapYear: Retourne un boolen indiquant si cette date se trouve dans une anne bissextile. Une anne bissextile est une anne qui a plus de jours (en raison d'un jour ou d'un mois intercalaire) qu'une anne commune. Dpend du calendrier.
Temporal.PlainDate.prototype.month: Retourne un entier positif reprsentant l'index du mois dans l'anne de cette date, bas sur 1. Le premier mois de cette anne est 1, et le dernier mois est le monthsInYear. Dpend du calendrier. Notez que contrairement Date.prototype.getMonth(), l'index est bas sur 1. Si le calendrier a des mois intercalaires, alors le mois avec le mme monthCode peut avoir des index de month diffrents pour diffrentes annes.
Temporal.PlainDate.prototype.monthCode: Retourne une chane de caractres spcifique au calendrier reprsentant le mois de cette date. Dpend du calendrier. Gnralement, c'est M suivi d'un numro de mois deux chiffres. Pour les mois intercalaires, c'est le code du mois prcdent suivi de L. Si le mois intercalaire est le premier mois de l'anne, le code est M00L.
Temporal.PlainDate.prototype.monthsInYear: Retourne un entier positif reprsentant le nombre de mois dans l'anne de cette date. Dpend du calendrier. Pour le calendrier ISO 8601, c'est toujours 12, mais dans d'autres systmes de calendrier, cela peut varier.
Temporal.PlainDate.prototype.weekOfYear: Retourne un entier positif reprsentant l'index de la semaine dans l'anne de cette date, bas sur 1, ou undefined si le calendrier n'a pas de systme de semaine bien dfini. La premire semaine de l'anne est 1. Dpend du calendrier. Notez que pour ISO 8601, les premiers et derniers jours de l'anne peuvent tre attribus la dernire semaine de l'anne prcdente ou la premire semaine de l'anne suivante.
Temporal.PlainDate.prototype.year: Retourne un entier reprsentant le nombre d'annes de cette date par rapport au dbut d'une anne d'poque spcifique au calendrier. Dpend du calendrier. Gnralement, l'anne 1 est soit la premire anne de la dernire re, soit l'anne ISO 8601 0001. Si l'poque est au milieu de l'anne, cette anne a la mme valeur avant et aprs la date de dbut de l're.
Temporal.PlainDate.prototype.yearOfWeek: Retourne un entier reprsentant l'anne associer l'index de la semaine de cette date, ou undefined si le calendrier n'a pas de systme de semaine bien dfini. Dpend du calendrier. Gnralement, c'est l'anne de la date, mais pour ISO 8601, les premiers et derniers jours de l'anne peuvent tre attribus la dernire semaine de l'anne prcdente ou la premire semaine de l'anne suivante, ce qui fait que yearOfWeek peut diffrer de 1.
Temporal.PlainDate.prototype[Symbol.toStringTag]: La valeur initiale de la proprit [Symbol.toStringTag] est la chane de caractres "Temporal.PlainDate". Cette proprit est utilise dans Object.prototype.toString().

Mthodes d'instance

Temporal.PlainDate.prototype.add(): Retourne un nouvel objet Temporal.PlainDate reprsentant cette date avance d'une dure donne (sous une forme convertible par Temporal.Duration.from()).
Temporal.PlainDate.prototype.equals(): Retourne true si cette date est quivalente en valeur une autre date (sous une forme convertible par Temporal.PlainDate.from()), et false sinon. Elles sont compares la fois par leurs valeurs de date et leurs calendriers.
Temporal.PlainDate.prototype.since(): Retourne un nouvel objet Temporal.Duration reprsentant la dure entre une autre date (sous une forme convertible par Temporal.PlainDate.from()) et cette date. La dure est positive si l'autre date est avant cette date, et ngative si elle est aprs.
Temporal.PlainDate.prototype.subtract(): Retourne un nouvel objet Temporal.PlainDate reprsentant cette date recule d'une dure donne (sous une forme convertible par Temporal.Duration.from()).
Temporal.PlainDate.prototype.toJSON(): Retourne une chane de caractres reprsentant cette date dans le mme format RFC 9557 que l'appel de toString(). Destin tre appel implicitement par JSON.stringify().
Temporal.PlainDate.prototype.toLocaleString(): Retourne une chane de caractres reprsentant cette date de manire sensible la langue.
Temporal.PlainDate.prototype.toPlainDateTime(): Retourne un nouvel objet Temporal.PlainDateTime reprsentant cette date et une heure fournie dans le mme systme de calendrier.
Temporal.PlainDate.prototype.toPlainMonthDay(): Retourne un nouvel objet Temporal.PlainMonthDay reprsentant le code du mois (monthCode) et le jour (day) de cette date dans le mme systme de calendrier.
Temporal.PlainDate.prototype.toPlainYearMonth(): Retourne un nouvel objet Temporal.PlainYearMonth reprsentant l'anne (year) et le mois (month) de cette date dans le mme systme de calendrier.
Temporal.PlainDate.prototype.toString(): Retourne une chane de caractres reprsentant cette date dans le format RFC 9557.
Temporal.PlainDate.prototype.toZonedDateTime(): Retourne un nouvel objet Temporal.ZonedDateTime reprsentant cette date, une heure fournie et un fuseau horaire fourni, dans le mme systme de calendrier.
Temporal.PlainDate.prototype.until(): Retourne un nouvel objet Temporal.Duration reprsentant la dure entre cette date et une autre date (sous une forme convertible par Temporal.PlainDate.from()). La dure est positive si l'autre date est aprs cette date, et ngative si elle est avant.
Temporal.PlainDate.prototype.valueOf(): Lve une TypeError, ce qui empche les instances de Temporal.PlainDate d'tre converties implicitement en primitives lorsqu'elles sont utilises dans des oprations arithmtiques ou de comparaison.
Temporal.PlainDate.prototype.with(): Retourne un nouvel objet Temporal.PlainDate reprsentant cette date avec certains champs remplacs par de nouvelles valeurs.
Temporal.PlainDate.prototype.withCalendar(): Retourne un nouvel objet Temporal.PlainDate reprsentant cette date interprte dans le nouveau systme de calendrier.

Spcifications

Spcification
Temporal # sec-temporal-plaindate-objects

Compatibilit des navigateurs

Voir aussi

Aider amliorer MDN

Cette page vous a-t-elle t utile ?

Oui Non

Apprendre contribuer

Cette page a t modifie le 19 aot 2026 par les contributeurices du MDN.

Voir cette page sur GitHub Signaler un problme avec ce contenu

Objets natifs standards
Temporal.PlainDate
Constructeur
1. Temporal.PlainDate()
Mthodes statiques
1. compare()
2. from()
Mthodes d'instance
1. add()
2. equals()
3. since()
4. subtract()
5. toJSON()
6. toLocaleString()
7. toPlainDateTime()
8. toPlainMonthDay()
9. toPlainYearMonth()
10. toString()
11. toZonedDateTime()
12. until()
13. valueOf()
14. with()
15. withCalendar()
Proprits d'instance
1. calendarId
2. day
3. dayOfWeek
4. dayOfYear
5. daysInMonth
6. daysInWeek
7. daysInYear
8. era
9. eraYear
10. inLeapYear
11. month
12. monthCode
13. monthsInYear
14. weekOfYear
15. year
16. yearOfWeek
Hritage
Object/Function
Mthodes statiques
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Proprits statiques
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Mthodes d'instance
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
Proprits d'instance
1. Object.prototype.__proto__
2. constructor
Pages similaires
Temporal
Temporal.Duration
Temporal.Instant
Temporal.Now
Temporal.PlainDateTime
Temporal.PlainMonthDay
Temporal.PlainTime
Temporal.PlainYearMonth
Temporal.ZonedDateTime