JavaScript String localeCompare() 方法

定義和用法

localeCompare() 方法在當前語言環境中比較兩個字符串。

localeCompare() 方法返回排序順序 -1、1 或 0（表示之前、之后或相等）。

當前語言環境基于瀏覽器的語言設置。

實例

例子 1

比較 "ab" 和 "cd"：

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

親自試一試

例子 2

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

親自試一試

例子 3

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

例子 4

親自試一試

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

親自試一試

語法

string.localeCompare(target)

參數

參數 描述
target 必需。要比較的字符串。

返回值

類型 描述
數字

3 個值之一：

  • -1，如果字符串被排在 target 之前
  •  0，如果兩個字符串相等
  •  1，如果字符串被排在 target 之后

技術細節

返回值

返回說明比較結果的數字。

如果 string 小于 target，則 localeCompare() 返回小于 0 的數。

如果 string 大于 target，則該方法返回大于 0 的數。

如果兩個字符串相等，或根據本地排序規則沒有區別，該方法返回 0。

說明

把 < 和 > 運算符應用到字符串時，它們只用字符的 Unicode 編碼比較字符串，而不考慮當地的排序規則。以這種方法生成的順序不一定是正確的。例如，在西班牙語中，其中字符 “ch” 通常作為出現在字母 “c” 和 “d” 之間的字符來排序。

localeCompare() 方法提供的比較字符串的方法，考慮了默認的本地排序規則。ECMAscript 標準并沒有規定如何進行本地特定的比較操作，它只規定該函數采用底層操作系統提供的排序規則。

瀏覽器支持

localeCompare() 是 ECMAScript1 (ES1) 特性。

所有瀏覽器都完全支持 ES1 (JavaScript 1997)：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 支持 支持 支持 支持 支持

相關頁面

JavaScript 字符串

JavaScript 字符串方法

JavaScript 字符串搜索