Глобализация

Глобализация

Получает информацию и выполняет операции, специфичные для пользователя язык и часовой пояс.

Объекты

Методы

Область действия переменной

globalizationОбъект является потомком navigator объект, и поэтому имеет глобальную область действия.

// The global globalization object
var globalization = navigator.globalization;

Доступ к функции

Начиная с версии 3.0 Кордова реализует интерфейсы API уровень устройства как плагины. Использование CLI plugin команды, описанные в интерфейс командной строки, чтобы добавить или удалить эту функцию для проекта:

    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-globalization.git
    $ cordova plugin rm org.apache.cordova.core.globalization

Эти команды применяются для всех целевых платформ, но изменить параметры конфигурации платформы, описанные ниже:

Некоторые платформы могут поддерживать эту функцию без необходимости специальной настройки. Смотрите поддержку платформы обзор.


globalization.getPreferredLanguage

Получите идентификатор строки для текущего языка клиента.

navigator.globalization.getPreferredLanguage(successCallback, errorCallback);

Описание

Возвращает строку идентификатора языка для successCallback с properties объект в качестве параметра. Этот объект должен иметь value свойство с String значение.

Если есть ошибка, как язык, то errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.UNKNOWN\_ERROR.

Поддерживаемые платформы

Быстрый пример

Когда браузер имеет значение en\_US языковой стандарт, это должно показать всплывающее диалоговое окно с текстом language: English :

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

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>getPreferredLanguage Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkLanguage() {
      navigator.globalization.getPreferredLanguage(
        function (language) {alert('language: ' + language.value + '\n');},
        function () {alert('Error getting language\n');}
      );
    }
    </script>
  </head>
  <body>
    <button onclick="checkLanguage()">Click for language</button>
  </body>
</html>

Windows Phone 8 причуды


globalization.getLocaleName

Получите идентификатор строки для текущей локали клиента.

navigator.globalization.getLocaleName(successCallback, errorCallback);

Описание

Возвращает строку идентификатора языкового стандарта для 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');}
);

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>getLocaleName Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkLocale() {
      navigator.globalization.getLocaleName(
        function (locale) {alert('locale: ' + locale.value + '\n');},
        function () {alert('Error getting locale\n');}
      );
    }
    </script>
  </head>
  <body>
    <button onclick="checkLocale()">Click for locale</button>
  </body>
</html>

Windows Phone 8 причуды


globalization.dateToString

Возвращает дату в формате строки согласно локали клиента и часовой пояс.

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

Описание

Возвращает отформатированную дату String через value свойств, доступных из объекта, переданного в качестве параметра дляsuccessCallback.

Входящий date параметр должен иметь типDate.

Если есть ошибка форматирования даты, то errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.FORMATTING\_ERROR.

optionsПараметр является необязательным, и его значения по умолчанию являются:

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

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' }
);

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>dateToString Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkDateString() {
      navigator.globalization.dateToString(
        new Date(),
        function (date) {alert('date: ' + date.value + '\n');},
        function () {alert('Error getting dateString\n');,
        {formatLength:'short', selector:'date and time'}}
      );
    }
    </script>
  </head>
  <body>
    <button onclick="checkDateString()">Click for date string</button>
  </body>
</html>

Windows Phone 8 причуды


globalization.stringToDate

Анализирует дату форматированы в виде строки, по словам клиента предпочтения пользователя и календарь с помощью часовой пояс клиента и возвращает соответствующий объект date.

navigator.globalization.stringToDate(dateString, successCallback, errorCallback, options);

Описание

Возвращает дату в успех обратного вызова с properties объект в качестве параметра. Этот объект должен иметь следующие свойства:

Входящий dateString параметр должен иметь типString.

optionsПараметр является необязательным и по умолчанию имеет следующие значения:

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

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'}
);

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>stringToDate Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkStringDate() {
      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'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkStringDate()">Click for parsed date</button>
  </body>
</html>

Windows Phone 8 причуды


globalization.getDatePattern

Возвращает строку шаблона для форматирования и разбора даты согласно предпочтениям пользователя клиента.

navigator.globalization.getDatePattern(successCallback, errorCallback, options);

Описание

Возвращает шаблон для successCallback . Объект, переданный в качестве параметра содержит следующие свойства:

Если есть ошибка получения шаблона, errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.PATTERN\_ERROR.

optionsПараметр является необязательным и по умолчанию имеет следующие значения:

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

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' }
    );
}

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>getDatePattern Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkDatePattern() {
      navigator.globalization.getDatePattern(
        function (date) {alert('pattern: ' + date.pattern + '\n');},
        function () {alert('Error getting pattern\n');},
        {formatLength:'short', selector:'date and time'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkDatePattern()">Click for pattern</button>
  </body>
</html>

Windows Phone 8 причуды


globalization.getDateNames

Возвращает массив, содержащий имена месяцев и дней недели, в зависимости от предпочтений пользователя и календарь клиента.

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' }
);

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>getDateNames Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkDateNames() {
      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'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkDateNames()">Click for date names</button>
  </body>
</html>

globalization.isDayLightSavingsTime

Указывает, является ли летнее время в силе для заданной даты, с использованием клиента часовой пояс и календаря.

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');}
);

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>isDayLightSavingsTime Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkDayLightSavings() {
      navigator.globalization.isDayLightSavingsTime(
        new Date(),
        function (date) {alert('dst: ' + date.dst + '\n');},
        function () {alert('Error getting names\n');}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkDayLightSavings()">Click for daylight savings</button>
  </body>
</html>

globalization.getFirstDayOfWeek

Возвращает первый день недели согласно календарь предпочтения пользователя и клиента.

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');}
);

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>getFirstDayOfWeek Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkFirstDay() {
      navigator.globalization.getFirstDayOfWeek(
        function (day) {alert('day: ' + day.value + '\n');},
        function () {alert('Error getting day\n');}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkFirstDay()">Click for first day of week</button>
  </body>
</html>

globalization.numberToString

Возвращает число, которое форматируется как строка согласно предпочтениям пользователя клиента.

navigator.globalization.numberToString(number, successCallback, errorCallback, options);

Описание

Возвращает форматируемую строку номер для successCallback с properties объект в качестве параметра. Этот объект должен иметь value свойство с String значение.

Если есть ошибка форматирования числа, то errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.FORMATTING\_ERROR.

optionsПараметр является необязательным, и его значения по умолчанию являются:

{type:'decimal'}

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'}
);

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>numberToString Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkNumber() {
      navigator.globalization.numberToString(
        3.1415926,
        function (number) {alert('number: ' + number.value + '\n');},
        function () {alert('Error getting number\n');},
        {type:'decimal'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkNumber()">Click for number</button>
  </body>
</html>

globalization.stringToNumber

Анализирует число, которое форматируется как строка согласно предпочтениям пользователя клиента и возвращает соответствующий номер.

navigator.globalization.stringToNumber(string, successCallback, errorCallback, options);

Описание

Возвращает номер для successCallback с properties объект в качестве параметра. Этот объект должен иметь value свойство с Number значение.

Если есть ошибка при разборе номер строки, а затем errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.PARSING\_ERROR.

optionsПараметр является необязательным и по умолчанию имеет следующие значения:

{type:'decimal'}

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'}
);

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>stringToNumber Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkNumber() {
      navigator.globalization.stringToNumber(
        '1234.56',
        function (number) {alert('number: ' + number.value + '\n');},
        function () {alert('Error getting number\n');},
        {type:'decimal'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkNumber()">Click for parsed number</button>
  </body>
</html>

globalization.getNumberPattern

Возвращает строку шаблона для форматирования и разбора чисел согласно предпочтениям пользователя клиента.

navigator.globalization.getNumberPattern(successCallback, errorCallback, options);

Описание

Возвращает шаблон для successCallback с properties объект в качестве параметра. Этот объект содержит следующие свойства:

Если есть ошибка получения шаблона, то свойство errorCallback выполняет с GlobalizationError объект в качестве параметра. Ожидаемый код ошибкиGlobalizationError.PATTERN\_ERROR.

optionsПараметр является необязательным, и значения по умолчанию являются:

{type:'decimal'}

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: ,

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>getNumberPattern Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkPattern() {
      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'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkPattern()">Click for pattern</button>
  </body>
</html>

Windows Phone 8 причуды


globalization.getCurrencyPattern

Возвращает строку шаблона для форматирования и синтаксического анализа значения валюты клиента предпочтения пользователя и код валюты ISO 4217.

 navigator.globalization.getCurrencyPattern(currencyCode, successCallback, errorCallback);

Описание

Возвращает шаблон для successCallback с properties объект в качестве параметра. Этот объект должен содержать следующие свойства:

Входящий 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: ,

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>getCurrencyPattern Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkPattern() {
      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');}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkPattern()">Click for pattern</button>
  </body>
</html>

GlobalizationError

Объект, представляющий ошибку от глобализации API.

Свойства

Описание

Этот объект создается и населенная Cordova и возвращается обратный вызов в случае ошибки.

Поддерживаемые платформы

Быстрый пример

Когда следующий ошибка обратного вызова выполняется, он отображает всплывающее диалоговое окно с текстом похож на code: 3 иmessage:

function errorCallback(error) {
    alert('code: ' + error.code + '\n' +
          'message: ' + error.message + '\n');
};

Полный пример

<!DOCTYPE HTML>
<html>
  <head>
    <title>GlobalizationError Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function successCallback(date) {
      alert('month:' + date.month +
            ' day:' + date.day +
            ' year:' + date.year + '\n');
    }

    function errorCallback(error) {
      alert('code: ' + error.code + '\n' +
            'message: ' + error.message + '\n');
    };

    function checkError() {
      navigator.globalization.stringToDate(
        'notADate',
        successCallback,
        errorCallback,
        {selector:'foobar'}
      );
    }

    </script>
  </head>
  <body>
    <button onclick="checkError()">Click for error</button>
  </body>
</html>