CurrencyFormatter  - AS3 Flex

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

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

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

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

Трехбуквенный код валюты ISO 4217 для фактической используемой локали (например, USD, EUR, JPY, CNY).

Если для свойства useCurrencySymbol установлено значение false, этот код обозначает тип валюты при форматировании денежных сумм с помощью метода format().

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

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

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

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

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

Это свойство используется для определения символа валюты при форматировании денежных сумм с помощью метода format() с параметром withCurrencySymbol, которому задано значение true.

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

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

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

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

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

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

В приведенной ниже таблице перечислены возможные шаблоны форматирования для отрицательных денежных сумм. Когда денежная сумма форматируется с помощью метода format():

• вместо символа «¤» подставляется значение свойства currencyISOCode или currencySymbol в зависимости от значения параметра withCurrencySymbol, переданного методу format();
• вместо символа «-» подставляется значение свойства negativeNumberSymbol;
• вместо символа «n» подставляется денежная сумма, переданная методу format().

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

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

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

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

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

В приведенной ниже таблице перечислены возможные шаблоны форматирования для положительных денежных сумм. Когда денежная сумма форматируется с помощью метода format():

• вместо символа «¤» подставляется значение свойства currencyISOCode или currencySymbol в зависимости от значения параметра withCurrencySymbol, переданного методу format();
• вместо символа «n» подставляется денежная сумма, переданная методу format().

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

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

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

Позволяет использовать свойство currencySymbol для форматирования денежных сумм.

Если для свойства useCurrencySymbol установлено значение true, то значение свойства currencySymbol используется в строке, возвращаемой методом format. Например, ;123,456,789.22

Если для свойства useCurrencySymbol установлено значение false, то значение свойства currencyISOCode используется в строке, возвращаемой методом format. Например: USD 123,456,789.22

Значением по умолчанию является false.

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

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

Конструирует новый объект CurrencyFormatter для форматирования чисел, представляющих денежные суммы, в соответствии с условиями данной локали.

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

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

      <fx:Declarations> 
             <s:CurrencyFormatter id="cf" /> 
      </fx:Declarations>
      

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

      <fx:Declarations> 
          <s:CurrencyFormatter id="cf_Japanese" locale="ja-JP" /> 
      </fx:Declarations>
      

• Вызов метода setStyle(), например cf.setStyle("locale", "ja-JP")
• Наследование стиля из UIComponent путем вызова метода addStyleClient() UIComponent.

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

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

Примечание. При использовании резервной локали для свойств валюты определены значения по умолчанию, в результате чего для свойства currencySymbol или currencyISOCode могут быть указаны непредвиденные значения. Рекомендуется проверить значения свойств currencySymbol и currencyISOCode, прежде чем форматировать денежную сумму.

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

Создается строка, которая представляет денежную сумму, отформатированную в соответствии с текущими свойствами данного объекта CurrencyFormatter, включая свойства locale, useCurrencySymbol, currencySymbol или currencyISOCode.

Свойство useCurrencySymbol определяет, будет ли метод формата использовать currencySymbol или currencyISOCode в отформатированной денежной сумме. Значением по умолчанию для useCurrencySymbol является false, поэтому денежные суммы будут по умолчанию форматироваться с помощью currencyISOCode

Во многих странах и регионах одинаковые символы валюты используются для обозначения разных денежных единиц. Например, в Соединенных Штатах, Австралии, Новой Зеландии, Канаде и Мексике используется один и тот же знак доллара ($) для обозначения местной валюты. Когда форматируемая валюта отличается от местной валюты пользователя, лучше использовать код ISO для обозначения валюты Чтобы проверить, соответствует ли код ISO валюты, которую необходимо отформатировать, коду ISO валюты по умолчанию для фактической локали, используемой средством форматирования, можно использовать метод formattingWithCurrencySymbolIsSafe().

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

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

Параметры

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

      <fx:Declarations>
        <s:CurrencyFormatter id="cf_use_ISOCode" locale="fr-CA" />
        <s:CurrencyFormatter id="cf_use_Symbol" locale="fr-CA" 
                           useCurrencySymbol="true" />
      </fx:Declarations>
      
      <s:VGroup>
        <!-- label will use ISO code: 1,234,567.89 CAD -->
        <s:Label text="{cf_use_ISOCode.format(1234567.89)}" /> 
        <!-- label will use currency symbol: 1,234,567.89 $ -->
        <s:Label text="{cf_use_Symbol.format(1234567.89)}" /> 
      </s:VGroup>
     
      

      <fx:Declarations>
       <s:CurrencyFormatter id="cf_CAD" locale="{LocaleID.DEFAULT}"
        currencyISOCode="CAD"
        useCurrencySymbol="{cf_CAD.formattingWithCurrencySymbolIsSafe('CAD')}"
       />
      </fx:Declarations>
      
      <fx:Script>
      <![CDATA[
          import flash.globalization.LocaleID;
      ]]>
      </fx:Script>
      
      <!-- label will use ISO code or currency symbol depending on
              user's default locale -->
      <s:Label text="{cf_CAD.format(1234567.89)}" />
      

Определяет, может ли текущий заданный символ валюты использоваться при форматировании денежных сумм.

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

Этот метод часто используется для определения того, следует отображать символ местной валюты (если сумма форматируется с использованием пользовательской валюты по умолчанию) или более точный код ISO (если сумма форматируется в валюте, отличной от используемой по умолчанию).

Этот метод сравнивает параметр requestedISOCode с currencyISOCode по умолчанию для фактической локали и возвращает true, если строки совпадают, и false, если не совпадают. Когда строки совпадают, использование метода format() со свойством useCurrencySymbol, которому задано значение true, приводит к тому, что отформатированная строка с денежной суммой будет содержать символ валюты, используемый в текущей локали. Если этот метод возвращает значение false, то использование метода format() со свойством useCurrencySymbol, которому задано значение true, может привести к использованию неоднозначного или некорректного символа валюты.

Параметры

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

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

Анализирует строку, возвращая денежную сумму и символ валюты.

Алгоритм анализа использует значение свойства decimalSeparator, чтобы определить целую и дробную часть числа. Он использует значения свойств negativeCurrencyFormat и positiveCurrencyFormat, чтобы определить местоположение символа или строки валюты относительно денежной суммы. Для отрицательных сумм свойство negativeCurrencyFormat определяет местоположение отрицательного символа и необходимость использования круглых скобок.

Если порядок символа валюты, символа «-» и числа в введенной строке не соответствует шаблону, определенному свойствами negativeCurrencyFormat и positiveCurrencyFormat, тогда:

1. свойству value возвращенного объекта CurrencyParseResult задается значение NaN;
2. свойству currencyString возвращенного объекта CurrencyParseResult задается значение null;
3. Для свойства lastOperationStatus устанавливается значение LastOperationStatus.PARSE_ERROR, указывающее на ошибку анализа.

Строка ввода может содержать пробелы, которые игнорируются в ходе анализа.

Анализ может успешно выполняться, даже если не указан символ валюты. Часть строки, соответствующая символу валюты, не проверяется. Если ввод не содержит символа или строки валюты, в качестве значения свойства currencyString возвращенного объекта CurrencyParseResult задается пустая строка.

Параметры

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