spark.formatters.supportClassesNumberFormatterBase Класс NumberFormatterBase является базовым классом для классов NumberFormatter и CurrencyFormatter.The <s:NumberFormatterBase> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:NumberFormatterBase 
    Properties
    decimalSeparator="locale and OS dependent"
    digitsType="locale and OS dependent"
    errorText="null"
    fractionalDigits="locale and OS dependent"
    groupingPattern="locale and OS dependent"
    groupingSeparator="locale and OS dependent"
    leadingZero="locale and OS dependent"
    negativeSymbol="locale and OS dependent"
    trailingZeros="locale and OS dependent"
    useGrouping="locale and OS dependent"
  />

]]>spark.globalization.supportClasses:GlobalizationBase Класс NumberFormatterBase является базовым классом для классов NumberFormatter и CurrencyFormatter.

spark.formatters.CurrencyFormatterspark.formatters.NumberFormatter

NumberFormatterBase Конструктор. Конструктор. decimalSeparator Символ-разделитель десятичной дроби, используемый для форматирования или анализа чисел с дробной частью.если это свойство имеет нулевое значение. TypeErrorTypeError Символ-разделитель десятичной дроби, используемый для форматирования или анализа чисел с дробной частью.

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

spark.formatters.CurrencyFormatter.format()spark.formatters.NumberFormatter.format()

digitsType Определяет набор цифровых символов, которые должны использоваться при форматировании чисел. Определяет набор цифровых символов, которые должны использоваться при форматировании чисел.

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

Значение этого свойства представляет значение Юникод для обозначения нуля в десятичном наборе цифр. Действительные значения для этого свойства определены в классе NationalDigitsType.

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

flash.globalization.NationalDigitsType

errorText Строка замены, возвращенная методом format() при возникновении ошибки.null Строка замены, возвращенная методом format() при возникновении ошибки.

Если errorText не является null и ошибка возникает при форматировании количества или денежной суммы, метод формата возвратит строку, присвоенную этому свойству.

Например: var nf:NumberFormatter = new NumberFormatter(); nf.setStyle("locale", "en-US"); nf.errorText = "###" trace(nf.format("abc")); // ###

spark.globalization.LastOperationStatus

fractionalDigits Максимальное число цифр, которые могут отображаться после десятичного разделителя. Максимальное число цифр, которые могут отображаться после десятичного разделителя.

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

Когда свойство trailingZeros имеет значение true, дробная часть числа (после запятой) дополняется нулями, чтобы ее длина соответствовала значению данного свойства fractionalDigits.

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

trailingZeros

groupingPattern Описывает размещение разделителей группировки в пределах отформатированной числовой строки.если это свойство имеет нулевое значение. TypeErrorTypeError Описывает размещение разделителей группировки в пределах отформатированной числовой строки.

Когда свойство useGrouping имеет значение true, свойство groupingPattern используется для определения местоположения разделителя группировки и используемого шаблона.

Шаблон группировки определяется как строка, содержащая числа, разделенные точкой с запятой и в некоторых случаях может оканчиваться звездочкой. Например: "3;2;*". Каждое число в строке представляет собой количество цифр в группе. Разделитель группировки помещается перед каждой группой цифр. Звездочка в конце строки обозначает, что группы с этим числом цифр должны повторяться до конца отформатированной строки. Если звездочки нет, то в оставшейся части отформатированной строки нет дополнительных групп или символов.

Первое число в строке соответствует первой группе цифр слева от десятичного разделителя. Последующие числа определяют количество цифр в следующих группах слева. Таким образом строка "3;2;*" обозначает, что разделитель группировки ставится после первой группы из 3 цифр, за которой следуют группы из 2 цифр. Например: 98,76,54,321

В следующей таблице приводятся примеры форматирования числа 123456789,12 с различными шаблонами группировки. В данном случае в качестве разделителя группировки используется запятая, а в качестве десятичного разделителя — точка.

Шаблон группировки Образец формата 3;* 123,456,789.12 3;2;* 12,34,56,789.12 3 123456,789.12

Можно определить лишь ограниченное число размеров группировки. В одних операционных системах шаблоны группировки могут содержать только два числа и звездочку. Другие операционные системы могут поддерживать до четырех чисел и звездочку. Когда речь идет о шаблонах без звездочки, одни операционные системы поддерживают только одно число, а другие до трех чисел. Если превышено максимальное число элементов группировки, то лишние элементы игнорируются и свойство lastOperationStatus обозначает, что используется резервное значение.

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

groupingSeparatoruseGrouping

groupingSeparator Символ или строка, используемые в качестве разделителя группировки.если это свойство имеет нулевое значение. TypeErrorTypeError Символ или строка, используемые в качестве разделителя группировки.

Значение этого свойства используется в качестве разделителя группировки при форматировании числа, когда свойство useGrouping имеет значение true. Это свойство изначально задается на основе локали, выбранной при создании объекта NumberFormatter.

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

spark.formatters.CurrencyFormatter.format()spark.formatters.NumberFormatter.format()useGroupinggroupingPattern

lastOperationStatus Состояние самой последней операции, выполненной этим объектом класса. Состояние самой последней операции, выполненной этим объектом класса. Свойство lastOperationStatus задается каждый раз при вызове конструктора или метода этого класса или при задании значения для другого свойства. Другие возможные значения см. в описании соответствующего метода. leadingZero Определяет, включается ли начальный нуль в отформатированное число, если слева от десятичного разделителя нет целых чисел.если это свойство имеет нулевое значение. TypeErrorTypeError Определяет, включается ли начальный нуль в отформатированное число, если слева от десятичного разделителя нет целых чисел.

Когда это свойство имеет значение true, начальный нуль добавляется слева от десятичного разделителя при форматировании числовых значений в диапазоне от -1,0 до 1,0. Когда это свойство имеет значение false, начальный нуль не добавляется.

Например, если форматируется число 0,321 и это свойство имеет значение true, в отформатированную строку включается начальный нуль. Если свойство имеет значение false, то начальный нуль не включается. В этом случае строка будет содержать только десятичный разделитель и дробную часть: ,321.

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

trailingZeros leadingZero fractionalDigits 0.12 0 true true 3 0.120 0.000 false true 3 0.12 0 true false 3 .120 .000 false false 3 .12 0

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

spark.formatters.CurrencyFormatter.format()spark.formatters.NumberFormatter.format()trailingZeros

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

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

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

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

negativeNumberFormatformat()

trailingZeros Определяет, добавляются ли нули в конце форматируемого числа.если это свойство имеет нулевое значение. TypeErrorTypeError Определяет, добавляются ли нули в конце форматируемого числа.

Когда это свойство имеет значение true, в конце дробной части отформатированного числа добавляются нули, чтобы его длина соответствовала ограничению, определенному в свойстве fractionalDigits. Когда это свойство имеет значение false, нули в конце числа не отображаются.

Например, если форматируется числовое значение 123,4 и это свойство имеет значение true, а свойству fractionalDigits задано значение 3, в конце отформатированной строки будут отображаться нули: 123,400. Если же это свойство имеет значение false, нули в конце строки не добавляются и после десятичного разделителя отображаются только ненулевые цифры: 123,4.

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

trailingZeros leadingZero fractionalDigits 0.12 0 true true 3 0.120 0.000 false true 3 0.12 0 true false 3 .120 .000 false false 3 .12 0

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

leadingZero

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

Когда свойство useGrouping имеет значение true, цифры группируются и разделяются с использованием символа-разделителя группировки. Например, 123,456,789.22

Когда свойство useGrouping имеет значение false, цифры не группируются и не разделяются. Например, 123456789.22

Символ, который должен использоваться в качестве разделителя группировки, определяется свойством groupingSeparator. Число знаком между разделителями группировки определяется свойством groupingPattern.

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

groupingPatterngroupingSeparator