El método JavaScript String localeCompare () comprueba si una cadena dada viene antes, después o es la misma que otra cadena en el orden de clasificación.
La sintaxis del localeCompare()
método es:
str.localeCompare(compareStr, locales, options)
Aquí str
hay una cuerda.
Parámetros localeCompare ()
El localeCompare()
método incluye:
- compareStr: la cadena con la que
str
se compara. - configuraciones regionales y opciones (opcional): estos argumentos personalizan la función especificando qué convenciones de formato usar.
Valor de retorno de localeCompare ()
- Devuelve un número negativo (-1) si la cadena de referencia se ordena antes que compareStr.
- Devuelve 0 si dos cadenas son equivalentes.
- Devuelve un número positivo (1) si la cadena de referencia se ordena después de compareStr.
Nota : Dado que los números enteros negativos y positivos que se muestran varían entre los navegadores, no confíe en los valores exactos -1 o 1 .
Ejemplo 1: uso de localeCompare ()
// letter 'h' comes after 'c' let result = "h".localeCompare("c"); console.log(result); // 1 // letter 'a' comes before 'c', so 'after' comes before 'car' let result1 = "after".localeCompare("car"); console.log(result1); // words 'JavaScript' & 'JavaScript' are equivalent let result2 = "JavaScript".localeCompare("JavaScript"); console.log(result2); // 0
Salida
1 -1 0
Ejemplo 2: uso de localeCompare () con configuraciones regionales y opciones
// using locale let value1 = "ä".localeCompare("z", "de"); console.log(value1); // a negative value: in German, ä sorts before z let value2 = "ä".localeCompare("z", "sv"); console.log(value2); // a positive value: in Swedish, ä sorts after z // default console.log("5".localeCompare("40")); // 1 // using options let value3 = "5".localeCompare("40", undefined, ( numeric: true )); console.log(value3); // a negative value let value4 = "Cliché".localeCompare("café", "fr", ( ignorePunctuation: true )); console.log(value4); // a positive value
Salida
-1 -1 1-1 1