Metode JavaScript String localeCompare () memeriksa apakah string yang diberikan muncul sebelum, sesudah, atau sama dengan string lain dalam urutan pengurutan.
Sintaks dari localeCompare()
metode ini adalah:
str.localeCompare(compareStr, locales, options)
Ini, str
adalah sebuah string.
localeCompare () Parameter
The localeCompare()
Metode mengambil di:
- bandingkanStr - String yang
str
dibandingkan. - lokal dan opsi (opsional) - Argumen ini menyesuaikan fungsi dengan menentukan konvensi pemformatan apa yang akan digunakan.
Kembalikan nilai dari localeCompare ()
- Mengembalikan angka negatif (-1) jika string referensi diurutkan sebelum bandingkanStr.
- Mengembalikan 0 jika dua string setara.
- Mengembalikan angka positif (1) jika string referensi diurutkan setelah bandingkanStr.
Catatan : Karena bilangan bulat negatif dan positif yang dikembalikan bervariasi antar browser, jangan mengandalkan nilai pasti -1 atau 1 .
Contoh 1: Menggunakan 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
Keluaran
1 -1 0
Contoh 2: Menggunakan localeCompare () dengan lokal dan opsi
// 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
Keluaran
-1 -1 1 -1 1