NumberFormatter  - AS3 Flex

Имя фактического идентификатора локали, используемое этим объектом класса. Эта локаль используется для доступа к форматированию данных и функциональным возможностям операционной системы.

Если локаль, установленная стилем locale, недоступна, то значение actualLocaleIDName будет отличаться от значения стиля locale. Значение будет указывать резервную используемую локаль. Если стиль локали установлен как LocaleID.DEFAULT, будет использоваться имя локали, определенное операционной системой пользователя.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Связанные элементы API

Числовое значение, которое обозначает шаблон форматирования для отрицательных чисел. Этот шаблон определяет местоположение отрицательного символа или круглых скобок относительно числовой части форматируемого числа.

В следующей таблице сведены все возможные форматы отрицательных чисел. При форматировании отрицательного числа знак «-» в шаблоне заменяется значением свойства negativeSymbol, а символ «n» заменяется отформатированным числовым значением.

Значение по умолчанию зависит от локали и операционной системы.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .

Связанные элементы API

Создает новый объект NumberFormatter для форматирования чисел в соответствии с правилами данной локали.

Стиль локали определяет локаль для этого класса. Стиль локали можно установить следующими способами:

• С использованием класса в объявлении MXML и наследованием локали из документа, содержащего объявление. Пример:

        <fx:Declarations> 
               <s:NumberFormatter id="nf" />
        </fx:Declarations>

• С использованием объявления MXML и указанием значения локали в списке назначений. Пример:

        <fx:Declarations>
            <s:NumberFormatter id="nf_French_France" locale="fr_FR" />
        </fx:Declarations>

• Вызов метода setStyle. Например:

        nf.setStyle("locale", "fr-FR")

• Наследование стиля из UIComponent путем вызова метода addStyleClient() UIComponent.

Если стиль locale не установлен одним из вышеперечисленных способов, экземпляр этого класса добавляется как StyleClient в topLevelApplication и наследует стиль locale из объекта topLevelApplication при вызове получателя свойств, зависящего от locale, или метода, зависящего от locale.

Многие свойства этого класса автоматически устанавливаются на основе стиля локали. При изменении стиля локали все свойства, которые не были явно указаны, будут обновлены в соответствии с новой локалью. Обратите внимание, что фактическая используемая локаль определяется в свойстве actualLocaleIDName.

Связанные элементы API

Форматирует число.

Эта функция форматирует число, на основе значений свойств объекта NumberFormatter. Если свойства не меняются после установки стиля locale, числа форматируются в соответствии с условиями, предоставляемыми операционной системой для локали, указанной в свойстве actualLocaleIDName. Чтобы настроить формат, можно изменить свойства для определения специфических аспектов форматирования числа.

Эта функция позволяет форматировать очень большие и очень малые числа. Однако число знаков ограничивается пределами точности, установленными объектом Number. Экспоненциальное представление не поддерживается.

Если возникла ошибка при форматировании вследствие указания недопустимого входного значения или других причин, метод format() по умолчанию возвращает null. Но если для свойства errorText указано ненулевое значение, то возвращается значение свойства errorText. Для свойства lastOperationStatus будет установлено значение, указывающее на возникновение ошибки.

Параметры

Связанные элементы API

Перечисляет все имена идентификаторов локалей, поддерживаемые этим классом. В этом списке представлены локали, поддерживаемые операционной системой, но не локали, для которых присутствуют ресурсы в ResourceManager.

Анализирует строку и возвращает объект NumberParseResult, содержащий проанализированные элементы.

Объект NumberParseResult содержит значение первого числа, найденного в указанной строке, начальный индекс для числа в строке, а также индекс первого символа после числа в строке.

Если строка не содержит числа, свойству NumberParseResult задается значение NaN, а свойствам startIndex и endIndex задается шестнадцатеричное значение 0x7fffffff.

Эта функция использует значение свойства decimalSeparator, чтобы определить дробную часть числа, свойство groupingSeparator, чтобы определить, какие символы разрешено использовать в пределах цифр числа, и свойство negativeNumberFormat, чтобы управлять представлением отрицательных чисел.

В следующей таблице перечислены результаты строк, проанализированных для различных значений NegativeNumberFormat.

Обратите внимание, что допускается использование одного пробела между числом и знаком «минус» или круглой скобкой. Разделитель — это символ, который имеет свойство разделителя-пробела (Zs) в базе данных символов Юникод. Для получения дополнительной информации см. http://www.unicode.org/ucd/).

При определении допустимого числа остальные свойства игнорируются. В частности, значение свойства digitsType игнорируется, и знаки могут находиться в любых наборах, перечисленных в классе NationalDigitsType. Значения свойств groupingPattern и useGrouping не влияют на анализ числа.

Если до или после числа в строке следует знак «+», он рассматривается как символ, не входящий в состав числа.

Эта функция не анализирует строки, содержащие числа в экспоненциальном представлении (например, 1,23e40).

Параметры

Связанные элементы API

      var nf:NumberFormatter = new NumberFormatter();
      nf.setStyle("locale","fr-FR");
      var str:String = "1,56 mètre"
      var result:NumberParseResult = nf.parse(str);
      trace(result.value) // 1.56
      trace(str.substr(0,result.startIndex));                // ""
      trace(str.substr(result.startIndex, result.endIndex)); // "1,56"
      trace(str.substr(result.endIndex));                 // " mètre"
      

Анализирует строку, которая содержит только цифры и/или пробелы, и возвращает число. Если строка не начинается с числа или содержит символы, отличные от пробела, которые не входят в состав числа, этот метод возвращает значение NaN. Пробел до или после числовых знаков игнорируется.

Если до или после цифры числа стоит знак «плюс» (+), он рассматривается не как символ пробела. Возвращается значение NaN.

См. описание функции анализа для получения дополнительной информации об анализе чисел и признаках допустимого числа.

Параметры

Связанные элементы API