Metode JavaScript String localeCompare()

Definisi dan penggunaan

localeCompare() Metode membandingkan dua string dalam lingkungan bahasa saat ini.

localeCompare() Metode mengembalikan urutan pengurutan -1,1 atau 0(menunjukkan sebelum, setelah, atau sama).

lingkungan bahasa saat ini berdasarkan pengaturan bahasa peramban.

Contoh

Contoh 1

Membandingkan "ab" dan "cd":

let text1 = "ab";
let text2 = "cd";
let result = text1.localeCompare(text2);

Coba sendiri

Contoh 2

let text1 = "cd";
let text2 = "ab";
let result = text1.localeCompare(text2);

Coba sendiri

Contoh 3

let text1 = "ab";
let text2 = "ab";
let result = text1.localeCompare(text2);

Contoh 4

Coba sendiri

let text1 = "A";
let text2 = "a";
let result = text1.localeCompare(text2);

Coba sendiri

Sintaks

string.localeCompare(target)

Parameter

Parameter Deskripsi
target Wajib. String yang akan dibandingkan.

Nilai pengembalian

Tipe Deskripsi
Numerik

3 nilai yang satu:

  • -1, jika string ditempatkan sebelum target
  • 　0, jika kedua string sama
  • 　1, jika string ditempatkan setelah target

Detil teknis

Nilai pengembalian

mengembalikan angka yang menunjukkan hasil pembandingan.

Jika string lebih kecil target, maka localeCompare() mengembalikan angka yang lebih kecil dari 0.

Jika string lebih besar target, maka metode ini mengembalikan angka yang lebih besar dari 0.

Jika kedua string sama, atau tidak berbeda menurut aturan pengurutan lokal, metode ini mengembalikan 0.

Penjelasan

Mengambil < dan > Operator yang diterapkan pada string hanya membandingkan string dengan kode Unicode karakter, tanpa memperhatikan aturan pengurutan lokal. Urutan yang dihasilkan dengan metode ini mungkin tidak benar. Contohnya, dalam bahasa Spanyol, karakter 'ch' biasanya diurutkan antara karakter 'c' dan 'd'.

localeCompare() Metode yang disediakan untuk membandingkan string, mempertimbangkan aturan pengurutan lokal standar. Standar ECMAscript tidak menentukan bagaimana melakukan operasi pembandingan lokal spesifik, ia hanya menentukan bahwa fungsi ini menggunakan aturan pengurutan yang disediakan oleh sistem operasi dasar.

Dukungan peramban

localeCompare() Adalah fitur ECMAScript1 (ES1).

Semua peramban sepenuhnya mendukung ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Dukungan Dukungan Dukungan Dukungan Dukungan Dukungan

Halaman-Relasi

String JavaScript

Metode String JavaScript

Pencarian String JavaScript