Этот модуль получает информацию и выполняет операции, специфичные для языка, язык и часовой пояс пользователя. Обратите внимание на разницу между и языка: язык элементов, как числа, даты и время отображаются для региона, в то время как язык определяет, какой язык текст отображается в виде, независимо от локали. Часто разработчики используют языковой стандарт для установки обоих параметров, но нет никаких причин, которые пользователь не мог установить ее язык «Английский язык», но языка «Французский», так что текст отображается на английском языке, но даты, время, и т.п., отображаются как они во Франции. К сожалению большинство мобильных платформ в настоящее время не проводится различие между этими параметрами.
cordova plugin add org.apache.cordova.globalization
Получите тег языка BCP 47 для клиента текущего языка.
navigator.globalization.getPreferredLanguage(successCallback, errorCallback);
Возвращает метку идентификатор совместимого языка BCP-47 к successCallback с properties объект в качестве параметра. Этот объект должен иметь value собственности с String значение.
Если есть ошибка, как язык, то errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.UNKNOWN_ERROR.
Когда браузер настроен en-US языке, это должно отображать всплывающее диалоговое окно с текстом language: en-US :
navigator.globalization.getPreferredLanguage(
function (language) {alert('language: ' + language.value + '\n');},
function () {alert('Error getting language\n');}
);
Возвращает в BCP 47 совместимый тег для текущей локали клиента.
navigator.globalization.getLocaleName(successCallback, errorCallback);
Возвращает строку идентификатор совместимого языка BCP 47 successCallback с properties объект в качестве параметра. Этот объект должен иметь value собственности с String значение. Тег языка будет состоять из двух букв нижнего регистра кода языка, код страны две буквы заглавные и (неопределенные) код варианта, разделенных дефисом.
Если есть ошибка получения локали, то errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.UNKNOWN_ERROR.
Когда браузер настроен en-US языка, это выводит всплывающее диалоговое окно с текстомlocale: en-US.
navigator.globalization.getLocaleName(
function (locale) {alert('locale: ' + locale.value + '\n');},
function () {alert('Error getting locale\n');}
);
navigator.globalizatin.getPreferredLanguage().Возвращает дату в формате строки согласно локали клиента и часовой пояс.
navigator.globalization.dateToString(date, successCallback, errorCallback, options);
Возвращает отформатированную дату String через value свойств, доступных из объекта, переданного в качестве параметра дляsuccessCallback.
Входящий date параметр должен иметь типDate.
Если есть ошибка форматирования даты, то errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.FORMATTING_ERROR.
optionsПараметр является необязательным, и его значения по умолчанию являются:
{formatLength: «короткая», селектор: «Дата и время»}
options.formatLengthМожет быть short , medium , long , илиfull.
options.selectorМожет быть date , time илиdate and time.
Если браузер настроен en_US языка, это выводит всплывающее диалоговое окно с текстом, похож на date: 9/25/2012 4:21PM с использованием параметров по умолчанию:
navigator.globalization.dateToString(
new Date(),
function (date) { alert('date: ' + date.value + '\n'); },
function () { alert('Error getting dateString\n'); },
{ formatLength: 'short', selector: 'date and time' }
);
formatLengthВариант поддерживает только short и full значения.formatLengthне различать long иfulllong или full версия)Возвращает строку шаблона для форматирования и анализа значений валют согласно ISO 4217 код валюты предпочтения пользователя и клиента.
navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);
Возвращает шаблон для successCallback с properties объект в качестве параметра. Этот объект должен содержать следующие свойства:
шаблон: валюты шаблон для форматирования и синтаксического анализа значения валюты. Шаблоны следуют технического стандарта Unicode #35. (Строка)
код: код валюты ISO 4217 для шаблона. (Строка)
фракция: количество дробных разрядов для использования когда синтаксический анализ и форматирование валюты. (Число)
округления: округление увеличивается для использования при синтаксического анализа и форматирования. (Число)
десятичное: десятичный символ использовать для синтаксического анализа и форматирования. (Строка)
Группировка: группировка символ использовать для синтаксического анализа и форматирования. (Строка)
Входящий currencyCode параметр должен быть String одного из кодов ISO 4217 валют, например «USD».
Если есть ошибка получения шаблона, то свойство errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.FORMATTING_ERROR.
Когда браузер настроен en_US языка и выбранной валюты это доллары США, этот пример отображает всплывающее диалоговое окно с текстом аналогичные результаты, которые следуют:
navigator.globalization.getCurrencyPattern(
'USD',
function (pattern) {
alert('pattern: ' + pattern.pattern + '\n' +
'code: ' + pattern.code + '\n' +
'fraction: ' + pattern.fraction + '\n' +
'rounding: ' + pattern.rounding + '\n' +
'decimal: ' + pattern.decimal + '\n' +
'grouping: ' + pattern.grouping);
},
function () { alert('Error getting pattern\n'); }
);
Ожидаемый результат:
pattern: $#,##0.##;($#,##0.##) code: USD fraction: 2 rounding: 0 decimal: . grouping: ,
Возвращает массив, содержащий названия месяцев или дней недели, в зависимости от предпочтений пользователя и календарь клиента.
navigator.globalization.getDateNames(successCallback, errorCallback, options);
Возвращает массив имен для successCallback с properties объект в качестве параметра. Этот объект содержит value собственности с Array из String значения. Имена функций массива, начиная с либо в первый месяц, в год или в первый день недели, в зависимости от выбранного варианта.
Если есть ошибка получения имена, а затем errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.UNKNOWN_ERROR.
optionsПараметр является необязательным, и его значения по умолчанию являются:
{type:'wide', item:'months'}
Значение options.type может быть narrow илиwide.
Значение options.item может быть months илиdays.
Когда браузер настроен en_US языка, в этом примере отображается ряд двенадцати всплывающих диалоговых окон, один в месяц, с текстом, похож на month: January :
navigator.globalization.getDateNames(
function (names) {
for (var i = 0; i < names.value.length; i++) {
alert('month: ' + names.value[i] + '\n');
}
},
function () { alert('Error getting names\n'); },
{ type: 'wide', item: 'months' }
);
options.typeподдерживает genitive значения, важные для некоторых языковВозвращает строку шаблона для форматирования и разбора даты согласно предпочтениям пользователя клиента.
navigator.globalization.getDatePattern(successCallback, errorCallback, options);
Возвращает шаблон для successCallback . Объект, переданный в качестве параметра содержит следующие свойства:
шаблон: Дата и время шаблон для форматирования и разбора дат. Шаблоны следуют технического стандарта Unicode #35. (Строка)
Часовой пояс: сокращенное название часового пояса на клиентском компьютере. (Строка)
utc_offset: текущий разница в секундах между часовой пояс и время клиента. (Число)
dst_offset: текущее смещение в летнее время в секундах между клиента не летнее часовой пояс и летнее клиента сохранение в часовой пояс. (Число)
Если есть ошибка получения шаблон, errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.PATTERN_ERROR.
optionsПараметр является необязательным и по умолчанию имеет следующие значения:
{formatLength: «короткая», селектор: «Дата и время»}
options.formatLength может быть short, medium, long или full. options.selectorМожет быть date , time илиdate and time.
Когда браузер настроен en_US языка, этот пример отображает всплывающее диалоговое окно с текстом, такие как pattern: M/d/yyyy h:mm a :
function checkDatePattern() {
navigator.globalization.getDatePattern(
function (date) { alert('pattern: ' + date.pattern + '\n'); },
function () { alert('Error getting pattern\n'); },
{ formatLength: 'short', selector: 'date and time' }
);
}
formatLengthПоддерживает только short и full значения.
patternДля date and time модель возвращает только полное datetime формат.
timezoneВозвращает имя зоны полный рабочий день.
dst_offsetСвойство не поддерживается, и всегда возвращает нуль.
Возвращает первый день недели согласно календаря предпочтения пользователя и клиента.
navigator.globalization.getFirstDayOfWeek(successCallback, errorCallback);
Дни недели нумеруются, начиная с 1, где 1 считается воскресенье. Возвращает день в successCallback с properties объект в качестве параметра. Этот объект должен иметь value собственности с Number значение.
Если есть ошибка получения шаблона, то свойство errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.UNKNOWN_ERROR.
Когда браузер настроен en_US языка, это выводит всплывающее диалоговое окно с текстом похож наday: 1.
navigator.globalization.getFirstDayOfWeek(
function (day) {alert('day: ' + day.value + '\n');},
function () {alert('Error getting day\n');}
);
Возвращает строку шаблона для форматирования и разбора номера согласно предпочтениям пользователя клиента.
navigator.globalization.getNumberPattern(successCallback, errorCallback, options);
Возвращает шаблон для successCallback с properties объект в качестве параметра. Этот объект содержит следующие свойства:
шаблон: шаблон номера для форматирования и синтаксического анализа чисел. Шаблоны следуют технического стандарта Unicode #35. (Строка)
символ: символ для использования при форматировании и синтаксическом разборе, например символ валюты и процентов. (Строка)
фракция: количество дробных разрядов для использования при синтаксического анализа и форматирования чисел. (Число)
округления: округление увеличивается для использования при синтаксического анализа и форматирования. (Число)
положительные: символ для положительных чисел, когда синтаксический анализ и форматирование. (Строка)
отрицательные: символ для отрицательных чисел, когда синтаксический анализ и форматирование. (Строка)
десятичное: десятичный символ использовать для синтаксического анализа и форматирования. (Строка)
Группировка: группировка символ использовать для синтаксического анализа и форматирования. (Строка)
Если есть ошибка получения шаблона, то свойство errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.PATTERN_ERROR.
optionsПараметр является необязательным, и значения по умолчанию являются:
{Тип: «десятичных»}
options.type может быть decimal, percent или currency.
Когда браузер настроен en_US языка, это должно отображать всплывающее диалоговое окно с текстом аналогичные результаты, которые следуют:
navigator.globalization.getNumberPattern(
function (pattern) {alert('pattern: ' + pattern.pattern + '\n' +
'symbol: ' + pattern.symbol + '\n' +
'fraction: ' + pattern.fraction + '\n' +
'rounding: ' + pattern.rounding + '\n' +
'positive: ' + pattern.positive + '\n' +
'negative: ' + pattern.negative + '\n' +
'decimal: ' + pattern.decimal + '\n' +
'grouping: ' + pattern.grouping);},
function () {alert('Error getting pattern\n');},
{type:'decimal'}
);
Результаты:
pattern: #,##0.### symbol: . fraction: 0 rounding: 0 positive: negative: - decimal: . grouping: ,
patternСвойство не поддерживается и retuens является пустой строкой.
fractionСвойство не поддерживается, и возвращает ноль.
Указывает, является ли летнее время в силе для заданной даты, с использованием клиента часовой пояс и календаря.
navigator.globalization.isDayLightSavingsTime(date, successCallback, errorCallback);
Указывает, является ли или не летнее время в силе до successCallback с properties объект в качестве параметра. Этот объект должен иметь dst свойство с Boolean значение. A true значение указывает, что летнее время в силе для заданной даты и false показывает, что это не.
Входящий параметр date должен иметь типDate.
Если есть ошибка чтения даты, то errorCallback выполняет. Ожидаемый код ошибкиGlobalizationError.UNKNOWN_ERROR.
В течение лета и если браузер настроен на часовой пояс, летнее время с поддержкой, это должно отображать всплывающее диалоговое окно с текстом похож на dst: true :
navigator.globalization.isDayLightSavingsTime(
new Date(),
function (date) {alert('dst: ' + date.dst + '\n');},
function () {alert('Error getting names\n');}
);
Возвращает число, которое форматируется как строка согласно предпочтениям пользователя клиента.
navigator.globalization.numberToString(number, successCallback, errorCallback, options);
Возвращает форматируемую строку номер для successCallback с properties объект в качестве параметра. Этот объект должен иметь value собственности с String значение.
Если есть ошибка форматирования числа, то errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.FORMATTING_ERROR.
optionsПараметр является необязательным, и его значения по умолчанию являются:
{Тип: «десятичных»}
options.type может быть ‘decimal’, ‘percent’ или ‘currency’.
Когда браузер настроен en_US языка, это выводит всплывающее диалоговое окно с текстом, похож на number: 3.142 :
navigator.globalization.numberToString(
3.1415926,
function (number) {alert('number: ' + number.value + '\n');},
function () {alert('Error getting number\n');},
{type:'decimal'}
);
Анализирует дату форматированы в виде строки, по словам клиента предпочтения пользователя и календарь с помощью часовой пояс клиента и возвращает соответствующий объект date.
navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options);
Возвращает дату в успех обратного вызова с properties объект в качестве параметра. Этот объект должен иметь следующие свойства:
год: год четыре цифры. (Число)
месяц: на месяц от (0-11). (Число)
день: день с (1-31). (Число)
час: час (0-23). (Число)
минута: минута (0-59). (Число)
второй: второй от (0-59). (Число)
МС: миллисекунд (от 0-999), не доступны на всех платформах. (Число)
Входящий dateString параметр должен иметь типString.
optionsПараметр является необязательным и по умолчанию имеет следующие значения:
{formatLength: «короткая», селектор: «Дата и время»}
options.formatLength может быть short, medium, long или full. options.selectorМожет быть date , time илиdate and time.
Если есть ошибка при разборе строки даты, то errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.PARSING_ERROR.
Когда браузер настроен en_US языка, это выводит всплывающее диалоговое окно с текстом, похож на month:8 day:25 year:2012 . Обратите внимание, что целое число является один месяц меньше, чем строка, как целое число месяца представляет индекс массива.
navigator.globalization.stringToDate(
'9/25/2012',
function (date) {alert('month:' + date.month +
' day:' + date.day +
' year:' + date.year + '\n');},
function () {alert('Error getting date\n');},
{selector: 'date'}
);
formatLengthВариант поддерживает только short и full значения.Анализирует число, которое форматируется как строка согласно предпочтениям пользователя клиента и возвращает соответствующий номер.
navigator.globalization.stringToNumber(string, successCallback, errorCallback, options);
Возвращает номер для successCallback с properties объект в качестве параметра. Этот объект должен иметь value свойство с Number значение.
Если есть ошибка при разборе номер строки, а затем errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.PARSING_ERROR.
optionsПараметр является необязательным и по умолчанию имеет следующие значения:
{Тип: «десятичных»}
options.type может быть decimal, percent или currency.
Когда браузер настроен en_US языка, это должно отображать всплывающее диалоговое окно с текстом, похож на number: 1234.56 :
navigator.globalization.stringToNumber(
'1234.56',
function (number) {alert('number: ' + number.value + '\n');},
function () {alert('Error getting number\n');},
{type:'decimal'}
);
Объект, представляющий ошибку от глобализации API.
Этот объект создается и населенная Cordova и возвращается обратный вызов в случае ошибки.
Когда следующий ошибка обратного вызова выполняется, он отображает всплывающее диалоговое окно с текстом похож на code: 3 иmessage:
function errorCallback(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
};