要查看英语原文,请勾选“英语”复选框。也可将鼠标指针移到文本上,在弹出窗口中显示英语原文。
翻译
英语

localeCompare 方法 (String) (JavaScript)

 

确定两个字符串在当前区域设置中是否相等。


stringVar.localeCompare(stringExp[, locales][, options]) 

stringVar

必需。要比较的第一个字符串。

stringExp

必需。要比较的第二个字符串。

locales

可选。包含一种或多种语言或区域设置标记的区域设置字符串数组。如果包含多个区域设置字符串,请以降序优先级对它们进行排列,确保首个条目为首选区域位置。如果省略此参数,则使用 JavaScript 运行时的默认区域设置。此参数必须符合 BCP 47 标准;请参见 Intl.Collator 对象了解详细信息。

options

可选。包含指定比较选项的一个或多个特性的对象。请参见 Intl.Collator 对象了解详细信息。

对于比较字符串,可以指定 String 对象或字符串文本。

从 Internet Explorer 11 开始,localeCompare 在内部使用 Intl.Collator 对象进行比较,添加对 localesoptions 参数的支持。有关这些参数的详细信息,请参见 Intl.CollatorIntl.Collator.compare

System_CAPS_important重要事项

localesoptions 参数在所有的文档模型和浏览器版本中均不支持。有关详细信息,请参见“要求”部分。

localeCompare 方法对 stringVarstringExp 执行区分区域设置的字符串比较,并返回以下结果之一,这取决于系统默认区域设置的排序顺序:

  • -1,如果 stringVar 排在 stringExp 之前。

  • +1,如果 stringVar 排在 stringExp 的后面。

  • 如果两个字符串相等,则为 0(零)。

下面的代码演示如何使用 localeCompare

var str1 = "def";
var str2 = "abc"

document.write(str1.localeCompare(str2) + "<br/>");

// Output: 1
var str3 = "ghi";

document.write(str1.localeCompare(str3)+ "<br/>");

// Output: -1
var str4 = "def";

document.write(str1.localeCompare(str4));

// Output: 0

下面的代码显示如何使用具有德语(德国)区域设置的 localeCompare

var str1 = "a";
var str2 = "b";

document.write(str1.localeCompare(str2, "de-DE"));

// Output
// - 1

下面的示例显示如何使用具有德语(德国)区域设置和指定德语电话簿排序顺序的区域设置特定扩展的 localeCompare此示例演示了特定于区域设置的差异。

var arr = ["ä", "ad", "af", "a"];

document.write(arr[0].localeCompare(arr[1], "de-DE-u-co-phonebk"));  // Returns 1
document.write (arr[0].localeCompare(arr[2], "de-DE-u-co-phonebk"));  // Returns -1
document.write (arr[0].localeCompare(arr[3], "de-DE-u-co-phonebk"));  // Returns 1

document.write (arr[0].localeCompare(arr[1], "de-DE"));  // Returns -1
document.write (arr[0].localeCompare(arr[2], "de-DE"));  // Returns -1
document.write (arr[0].localeCompare(arr[3], "de-DE"));  // Returns 1

要求

在以下文档模式中受支持:Quirks、Internet Explorer 6 标准模式、Internet Explorer 7 标准模式、Internet Explorer 8 标准模式、Internet Explorer 9 标准模式、Internet Explorer 10 标准模式和 Internet Explorer 11 标准模式。此外,也在应用商店应用(Windows 8 和 Windows Phone 8.1)中受支持。请参阅版本信息

localesoptions 参数:

在 Internet Explorer 11 标准文档模式下支持此项。此外,也在应用商店应用(Windows 8.1 和 Windows Phone 8.1)中受支持。请参阅版本信息

在以下文档模式中不受支持:Quirks、Internet Explorer 6 标准模式、Internet Explorer 7 标准模式、Internet Explorer 8 标准模式、Internet Explorer 9 标准模式和 Internet Explorer 10 标准模式。在 Windows 8 中不受支持。

显示: