Temporal.PlainTime : 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.PlainTime.compare() retourne un nombre (-1, 0 ou 1) indiquant si la première heure est avant, identique ou après la deuxième heure. Elle équivaut à comparer les champs heure, minute, seconde, milliseconde, microseconde et nanoseconde un par un.
Syntaxe
Temporal.PlainTime.compare(time1, time2)
Paramètres
time1-
Une chaîne de caractères, un objet ou une instance de
Temporal.PlainTimereprésentant la première heure à comparer. Elle est convertie en objetTemporal.PlainTimeen utilisant le même algorithme queTemporal.PlainTime.from(). time2-
La deuxième heure à comparer, convertie en objet
Temporal.PlainTimeen utilisant le même algorithme quetime1.
Valeur de retour
Retourne -1 si time1 est avant time2, 0 s'ils sont identiques, et 1 si time1 est après time2.
Exemples
Utiliser la méthode Temporal.PlainTime.compare()
const time1 = Temporal.PlainTime.from("12:34:56");
const time2 = Temporal.PlainTime.from("12:34:57");
console.log(Temporal.PlainTime.compare(time1, time2)); // -1
const time3 = Temporal.PlainTime.from("11:34:56");
console.log(Temporal.PlainTime.compare(time1, time3)); // 1
Trier un tableau d'heures
Le but de cette fonction compare() est de servir de comparateur à passer à Array.prototype.sort() et aux fonctions similaires.
const times = ["12:34:56", "11:34:56", "12:34:57"];
times.sort(Temporal.PlainTime.compare);
console.log(times);
// [ "11:34:56", "12:34:56", "12:34:57" ]
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.plaintime.compare |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.PlainTime - La méthode
Temporal.PlainTime.prototype.equals()