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 compare() des instances de Temporal.Instant 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()