Temporal.PlainDate : méthode statique compare()

Disponibilité limitée

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

La méthode statique Temporal.PlainDate.compare() des instances de Temporal.PlainDate retourne un nombre (-1, 0 ou 1) indiquant si la première date est antérieure, identique ou postérieure à la seconde date. Équivalent à la comparaison des champs année, mois et jour des dates ISO 8601 sous-jacentes.

Syntaxe

Temporal.PlainDate.compare(date1, date2)

Paramètres

date1: Une chaîne de caractères, un objet ou une instance de Temporal.PlainDate représentant la première date à comparer. Elle est convertie en objet Temporal.PlainDate en utilisant le même algorithme que Temporal.PlainDate.from().
date2: La deuxième date à comparer, convertie en objet Temporal.PlainDate en utilisant le même algorithme que date1.

Valeur de retour

Retourne -1 si date1 est antérieure à date2, 0 si elles sont identiques, et 1 si date1 est postérieure à date2. Elles sont comparées par leurs valeurs de date sous-jacentes, en ignorant leurs calendriers.

Exemples

Utiliser la méthode `Temporal.PlainDate.compare()`

const date1 = Temporal.PlainDate.from("2021-08-01");
const date2 = Temporal.PlainDate.from("2021-08-02");
console.log(Temporal.PlainDate.compare(date1, date2)); // -1

const date3 = Temporal.PlainDate.from("2021-07-31");
console.log(Temporal.PlainDate.compare(date1, date3)); // 1

Comparer des dates dans différents calendriers

const date1 = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const date2 = Temporal.PlainDate.from({
  year: 2021,
  month: 8,
  day: 1,
  calendar: "islamic-umalqura",
});
const date3 = Temporal.PlainDate.from({
  year: 2021,
  month: 8,
  day: 1,
  calendar: "hebrew",
});
console.log(date1.toString()); // "2021-08-01"
console.log(date2.toString()); // "2582-12-17[u-ca=islamic-umalqura]"
console.log(date3.toString()); // "-001739-04-06[u-ca=hebrew]"
console.log(Temporal.PlainDate.compare(date1, date2)); // -1
console.log(Temporal.PlainDate.compare(date1, date3)); // 1

Trier un tableau de dates

Le but de cette fonction compare() est d'agir comme un comparateur à passer à Array.prototype.sort() et aux fonctions associées.

const dates = [
  Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 }),
  Temporal.PlainDate.from({
    year: 2021,
    month: 8,
    day: 1,
    calendar: "islamic-umalqura",
  }),
  Temporal.PlainDate.from({ year: 2021, month: 8, day: 1, calendar: "hebrew" }),
];

dates.sort(Temporal.PlainDate.compare);
console.log(dates.map((d) => d.toString()));
// [ "-001739-04-06[u-ca=hebrew]", "2021-08-01", "2582-12-17[u-ca=islamic-umalqura]" ]

Spécifications

Spécification
Temporal # sec-temporal.plaindate.compare

Compatibilité des navigateurs

Voir aussi

L'objet Temporal.PlainDate
La méthode Temporal.PlainDate.prototype.equals()

Aider à améliorer MDN

Apprendre à contribuer

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

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