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.
Want more support for this feature? Tell us why.
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()