Temporal.Instant : 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.Instant.compare() retourne un nombre (-1, 0 ou 1) indiquant si le premier instant est antérieur, identique ou postérieur au second instant. Elle est équivalente à la comparaison des epochNanoseconds des deux instants.
Syntaxe
Temporal.Instant.compare(instant1, instant2)
Paramètres
instant1-
Une chaîne de caractères ou une instance de
Temporal.Instantreprésentant le premier instant à comparer. Il est converti en objetTemporal.Instanten utilisant le même algorithme queTemporal.Instant.from(). instant2-
Le second instant à comparer, converti en objet
Temporal.Instanten utilisant le même algorithme queinstant1.
Valeur de retour
Retourne -1 si instant1 est antérieur à instant2, 0 s'ils sont identiques, et 1 si instant1 est postérieur à instant2.
Exemples
Utiliser la méthode compare()
const instant1 = Temporal.Instant.from("2021-08-01T12:34:56Z");
const instant2 = Temporal.Instant.from("2021-08-01T12:34:56Z");
console.log(Temporal.Instant.compare(instant1, instant2)); // 0
const instant3 = Temporal.Instant.from("2021-08-01T13:34:56Z");
console.log(Temporal.Instant.compare(instant1, instant3)); // -1
Trier un tableau d'instants
L'objectif de cette fonction compare() est d'agir comme un comparateur à passer à Array.prototype.sort() et aux fonctions associées.
const instants = [
Temporal.Instant.from("2021-08-01T12:34:56Z"),
Temporal.Instant.from("2021-08-01T12:34:56+01:00"),
Temporal.Instant.from("2021-08-01T12:34:56-01:00"),
];
instants.sort(Temporal.Instant.compare);
console.log(instants.map((instant) => instant.toString()));
// [ '2021-08-01T11:34:56Z', '2021-08-01T12:34:56Z', '2021-08-01T13:34:56Z' ]
Spécifications
| Spécification |
|---|
| Temporal # sec-temporal.instant.compare |
Compatibilité des navigateurs
Voir aussi
- L'objet
Temporal.Instant - La méthode
Temporal.Instant.prototype.equals()