全球化插件


此插件用于获取有关用户语言区域语言,日期和时区,货币等的信息。现在支持iOSAndroidWindows设备

这个插件得到的信息和执行操作的特定于用户的 现场、语言和时区。注意区域设置和语言之间的区别: 现场控制数字、日期和时间显示为一个区域,而 语言决定什么语言文本出现,独立的区域设置。

这个插件定义了全球navigator.globalization对象(在deviceready事件后才能使用)

document.addEventListener("deviceready", onDeviceReady, false);
    function onDeviceReady() {
        console.log(navigator.globalization);
    }

对象

globalizationerror

方法

navigator.globalization.getpreferredlanguage

navigator.globalization.getlocalename

navigator.globalization.datetostring

navigator.globalization.stringtodate

navigator.globalization.getdatepattern

navigator.globalization.getdatenames

navigator.globalization.isdaylightsavingstime

navigator.globalization.getfirstdayofweek

navigator.globalization.numbertostring

navigator.globalization.stringtonumber

navigator.globalization.getnumberpattern

navigator.globalization.getcurrencypattern

navigator.globalization.getpreferredlanguage

得到BCP 47语言标签对客户当前的语言。

navigator.globalization.getPreferredLanguage(successCallback, errorCallback)

返回bcp-47兼容的语言标识符标签successCallback用一个性能对象作为参数。这个对象应该有一个value String 值。

如果有一个错误的语言,然后errorCallback执行一个GlobalizationError 对象作为参数。错误的预期的 代码globalizationerror.UNKNOWN_ERROR

例子:

当浏览器设置en-US为语言,这应该与文本 弹出对话框显示语言:en-US

navigator.globalization.getPreferredLanguage

        function (language) {alert('language: ' + language.value + '\n');},

        function () {alert('Error getting language\n');}

    );

注意:

Android返回ISO 639-1/ISO两个字母的语言代码,大写 ISO 3166-1国家代码和变量由连字符分隔的。例如: "en", "en-US", "US"

Windows返回ISO 639-1/ISO两个字母的语言代码和ISO 3166-1国家代码 对应的“语言”设置区域性变体,由连字符分隔 。

navigator.globalization.getLocaleName

返回BCP 47兼容的标签为客户的当前区域设置。

navigator.globalization.getLocaleName(successCallback, errorCallback);

返回BCP 47兼容的区域设置标识符字符串的successCallback用一个属性对象作为参数。这个对象应该有一个valueString值。现场的标签将包括12个字母下 案例语言代码,两字母大写国家代码,和(不详)变 代码,连字符分隔的。 

如果有一个错误的地方,然后errorCallback执行一个GlobalizationError 对象作为参数。错误的预期的 代码globalizationerror.UNKNOWN_ERROR

例子:

navigator.globalization.getLocaleName(
        function (locale) {alert('locale: ' + locale.value + '\n');},
        function () {alert('Error getting locale\n');}
    );

注意:

Android:java不区分“langauge”和“locale之间,所以这 方法基本上是和navigator.globalization.getPreferredLanguage()相同

Windows:

区域设置可以在控制面板-改变>时钟、语言和区域 ->区->格式->格式, 和设置->区域->区域格式在Windows Phone。

navigator.globalization.datetostring

返回日期格式化为字符串按照客户的地点和时区。

navigator.globalization.dateToString(date, successCallback, errorCallback, options);

返回格式化的日期字符串通过一value属性访问 从对象作为参数传递给successCallback。

如果有一个格式错误的日期,然后errorCallback执行一个GlobalizationError 对象作为参数。错误的预期的 代码GlobalizationError.FORMATTING_ERROR。

option数是可选的,它的默认值:

{formatLength:'short', selector:'date and time'}

这个options.formatlength可以是short, medium, long, full.

这个options.selector可以是date, timedate  time

例子:

如果浏览器设置为en_us现场,这将显示一个弹出式对话框的文本相似date:9/25/2012 4:21pm使用默认的 option:

navigator.globalization.dateToString(
        new Date(),
        function (date) { alert('date: ' + date.value + '\n'); },
        function () { alert('Error getting dateString\n'); },
        { formatLength: 'short', selector: 'date and time' }
    );

提供其他方法。可以参考下面的表中所有的。

方法

参数

细节

getPreferredLanguage

onSuccessonError

返回客户端当前的语言。

getLocaleName

onSuccessonError

返回客户端的当前语言环境设置。

dateToString

date,onSuccessonErroroptions

根据客户的区域设置和时区返回日期。

stringToDate

dateStringonSuccessonErroroptions

根据客户端的设置解析日期。

getCurrencyPattern

currencyCodeonSuccessonError

返回客户的货币模式。

getDatePattern

onSuccessonErroroptions

返回客户端的日期模式。

getDateNames

onSuccessonErroroptions

根据客户端的设置返回月,周或天的名称数组。

isDayLightSavingsTime

datesuccessCallbackerrorCallback

用于根据客户端的时区和日历确定夏令时是否活动。

getFirstDayOfWeek

onSuccessonError

根据客户端设置返回一周的第一天。

numberToString

numberonSuccessonErroroptions

根据客户端的设置返回number

stringToNumber

stringonSuccessonErroroptions

根据客户端的设置解析一个数字。

getNumberPattern

onSuccessonErroroptions

根据客户端的设置返回数字模式。