NumberFormatter  - AS3

此 NumberFormatter 对象使用的实际区域设置 ID 的名称。

根据操作系统和传递给 Collator() 构造函数的 requestedLocaleIDName 参数的值，该名称有三种可能的值。

1. 如果请求的区域设置不是 LocaleID.DEFAULT 且操作系统支持该请求的区域设置，则返回的名称与 requestedLocaleIDName 属性相同。
2. 如果将 LocaleID.DEFAULT 用作构造函数的 requestedLocaleIDName 参数的值，则使用由用户操作系统指定的当前区域设置的名称。LocaleID.DEFAULT 值保留用户在操作系统中的自定义设置。显式值作为 requestedLocaleIDName 参数传递与使用 LocaleID.DEFAULT 所产生的结果不一定相同，即使两个区域设置 ID 名称相同，也是如此。用户可能已在他们的计算机上对区域设置进行了自定义，通过请求显式区域设置 ID 名称（而不是使用 LocaleID.DEFAULT），您的应用程序将不会检索这些自定义设置。
3. 如果系统不支持在构造函数中指定的 requestedLocaleIDName，则会提供回退区域设置 ID 名称。

相关 API 元素

为包含小数部分的数字设置格式或对其进行解析时使用的小数分隔符字符。

基于在构造格式程序对象时选择的区域设置对此属性进行最初设置。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

默认值为 dependent on the locale and operating system.。

相关 API 元素

定义为数字设置格式时使用的数字字符集。

不同语言和区域使用不同的字符集表示数字 0 到 9。此属性定义要使用的数字集。

此属性值表示十进制数字集中数字 0 的 Unicode 值。在 NationalDigitsType 类中定义此属性的有效值。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

默认值为 dependent on the locale and operating system.。

相关 API 元素

小数分隔符后可以显示的最大位数。

数字舍入为由此属性指定的数字位数。舍入方案根据用户的操作系统不同而有所不同。

当 trailingZeros 属性设置为 true 时，用尾随零来填充数字的小数部分（小数点之后），直到数字长度与此 fractionalDigits 属性的值相匹配。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

默认值为 0。

相关 API 元素

描述分组分隔符在设置了格式的数字字符串中的位置。

将 useGrouping 属性设置为 true 时，groupingPattern 属性用于定义分组分隔符所用的位置和模式。

分组模式定义为包含由分号分隔并可能以星号结尾的数字的字符串。例如：“3;2;*”。字符串中的每个数字表示组中数字位数。分组分隔符置于每个数字组之前。字符串结尾的星号表示应在设置了格式的字符串的其余部分重复包含这一数字位数的组。如果没有星号，则在设置了格式的字符串的其余部分不会有其他组或分隔符。

字符串中的第一个数字对应于小数分隔符左边的第一组数字。随后的数字定义左边随后组中的数字位数。因此字符串“3;2;*”表示分组分隔符置于第一组 3 位数之后，后面跟 2 位数的组。例如：98,76,54,321

下表提供了使用多种分组模式为数字 123456789.12 设置格式的示例。分组分隔符为逗号，小数分隔符为句点。

仅可以定义有限的分组数字个数。在某些操作系统上，分组模式只能包含两个数字加一个星号。其他操作系统最多可以支持四个数字加一个星号。对于不含星号的模式，某些操作系统只支持一个数字，而其它操作系统最多支持三个数字。如果超过分组模式元素的最大数，则忽略其他元素，并按如下所述设置 lastOperationStatus 属性。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

用于分组分隔符的字符或字符串。

当 useGrouping 属性设置为 true 时，在设置数字格式时此属性的值用作分组分隔符。基于在构造格式程序对象时选择的区域设置对此属性进行最初设置。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

默认值为 dependent on the locale and operating system.。

相关 API 元素

此 NumberFormatter 对象执行的前一操作的状态。只要调用构造函数或此类的方法或设置另一个属性，就会设置 lastOperationStatus 属性。有关可能的值，请参阅每种方法的说明。

相关 API 元素

指定当小数分隔符左侧没有整数位时，设置了格式的数字中是否包括前导零。

当此属性设置为 true 时，在设置 -1.0 到 1.0 之间的数值的格式时，小数分隔符左侧包括前导零。当此属性设置为 false 时，不包括前导零。

例如，如果数字是 0.321，并且此属性设置为 true，则在设置了格式的字符串中包括前导零。如果将此属性设置为 false，则不包括前导零。在这种情况下，字符串将只在十进制数字前包括小数分隔符，如 .321。

下表提供了几个示例，显示如何基于此属性以及相关的 fractionalDigits 和 trailingZeros 属性的值来设置数字的格式。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

默认值为 dependent on the locale and operating system.。

相关 API 元素

表示负数的格式设置模式的数值。此模式定义负号或圆括号相对于设置了格式的数字的数字部分的位置。

下表总结了可能的负数格式。当设置负数的格式时，格式中的负号由 negativeSymbol 属性的值替换，“n”字符由设置了格式的数值替换。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

默认值为 dependent on the locale and operating system.。

相关 API 元素

设置负值的格式时使用的负号。

为小于零的数字设置格式时，将此符号与负数格式一同使用。在不包括负号的负数格式中不使用它（例如，使用圆括号括起的负数）。

此属性设置为构造此格式程序时选择的实际区域。可以使用某个值设置它以覆盖默认设置。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

传递到此 NumberFormatter 对象的构造函数的请求的区域设置 ID 名称。

如果使用了 LocaleID.DEFAULT 值，则返回的名称将是“i-default”。如果应用了回退区域设置，则实际使用的区域设置可能与请求的区域设置不同。可以使用 actualLocaleIDName 属性检索实际区域设置的名称。

相关 API 元素

指定设置了格式的数字中是否包括尾随零。

当此属性设置为 true 时，设置了格式的数字的小数部分包括尾随零，并且位数限制为 fractionalDigits 属性指定的值。当此属性设置为 false 时，则不显示尾随零。

例如，如果数值是 123.4，并且此属性设置为 true，fractionalDigits 的属性设置为 3，则此设置了格式的字符串将显示尾随零，形如 123.400。如果此属性为 false，则不包括尾随零，并且该字符串仅显示小数分隔符以及后面的非零十进制数，形如 123.4。

下表提供了几个示例，显示如何基于此属性以及相关的 fractionalDigits 和 leadingZero 属性的值来设置数值的格式。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

默认值为 dependent on the locale and operating system.。

相关 API 元素

当设置数字格式时，启用分组分隔符。

当 useGrouping 属性设置为 true 时，数字进行分组并且使用分组分隔符字符进行分隔。例如：123,456,789.22

当 useGrouping 属性设置为 false 时，数字不进行分组或分隔。例如：123456789.22

用作组分隔符的符号由 groupingSeparator 属性定义。分组分隔符之间的数字位数由 groupingPattern 属性定义。

为此属性分配了值并且未引发错误或警告时，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

构造新的 NumberFormatter 对象以根据给定区域设置的约定设置数字的格式。

此构造函数确定当前操作系统是否支持请求的区域设置 ID 名称。如果不支持，则使用回退区域设置。如果使用了回退区域设置，则 lastOperationStatus 属性表示回退类型，并且 actualLocaleIDName 属性包含回退区域设置 ID 的名称。

要根据用户的当前操作系统首选项进行格式设置，请将 requestedLocaleIDName 参数中的值 LocaleID.DEFAULT 传递给构造函数。

当构造函数成功完成后，将 lastOperationStatus 属性将设置为：

• LastOperationStatus.NO_ERROR

如果请求的区域设置 ID 名称不可用，则将 lastOperationStatus 属性设置为下列属性之一：

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

如果当前操作系统不支持此类，则将 lastOperationStatus 属性将设置为：

• LastOperationStatus.UNSUPPORTED_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的其中一个常量。

有关以上列出的警告和 lastOperationStatus 属性其他可能值的详细信息，请参阅 LastOperationStatus 类中的说明。

相关 API 元素

设置 int 值的格式。除采用 int 值外，此函数等效于 formatNumber() 方法。如果传入的值过大或过小，例如值大于 1.72e308 或小于 1.72e-308，则此函数返回 0。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

设置 Number 值格式。

此函数根据格式程序的属性值设置数字格式。如果在创建 numberFormatter 对象后没有修改属性，则根据操作系统提供的由 actualLocaleIDName 标识的区域设置的特定于区域设置的约定为数字设置格式。要自定义格式，可以更改属性以控制设置数字格式的特定方面。

可以使用此函数设置非常大的数字和非常小的量级的数字的格式。但有效位数不得超过 Number 对象提供的精度。不支持科学计数法。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

设置 uint 值格式。除采用 uint 之外，此函数等效于 formatNumber() 方法。如果传入的值过大，例如值大于 1.72e308，则此函数返回 0。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

列出此类支持的所有区域设置 ID 名称。

如果当前操作系统不支持此类，此方法返回 null 值。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

解析字符串并返回包含解析的元素的 NumberParseResult 对象。

NumberParseResult 对象包含在输入字符串中找到的第一个数字的值、字符串内数字的起始索引以及字符串中数字之后的第一个字符的索引。

如果字符串中不包含数字，NumberParseResult 的属性值设置为 NaN，startIndex 和 endIndex 属性值设置为十六进制值 0x7fffffff。

此函数使用 decimalSeparator 属性的值确定包含小数的数字部分，使用 groupingSeparator 属性确定数字位数内允许的字符，使用 negativeNumberFormat 属性控制负值的表示方法。

下表标识为不同的 NegativeNumberFormat 值解析的字符串的结果：

允许数字和负号或括号之间存有单个空格。

确定有效的数字时，忽略其它属性。具体来说，忽略 digitsType 属性的值，并且数字可以来自 NationalDigitsType 类中枚举的任何数字集。groupingPattern 和 useGrouping 属性的值不影响数字的解析。

如果字符串中数字的前面或后面有加号“+”，加号被视为不属于数字部分的字符。

此函数不解析包含以科学记数法表示的数字（例如，1.23e40）的字符串。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

 
         var nf:NumberFormatter = new NumberFormatter("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。忽略数字前后的空格。空白字符是 Unicode 字符数据库（请参阅 http://www.unicode.org/ucd/）中具有 Space Separator (Zs) 属性的字符。

如果数字位数前面或后面跟着一个加号“+”，这个加号作为非空白字符处理。返回值为 NaN。

有关数字解析和有效数字构成部分的更多信息，请参阅解析功能的说明。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

此示例使用以下区域设置：针对数字格式的默认操作系统区域设置、日语（日本）、英语（美国）和法语（法国）。此示例使用静态成员 LocaleID.DEFAULT 请求默认操作系统区域设置。

此示例中的结果可能因操作系统和用户首选项不同而异。

此示例针对列表中的每个区域设置执行以下操作：

1. 创建 NumberFormatter 对象。
2. 将同一个值的格式设置为数字、整数和无符号整数，并显示结果。

 
package {
    import flash.globalization.NumberFormatter;
    import flash.globalization.LocaleID;
    
    public class NumberFormatterExample extends Sprite
    {
        public function NumberFormatterExample():void
        {
            var localeNames:Array = [LocaleID.DEFAULT,"ja_JP","en_US","fr_FR"];
            
            for ( var i:int = 0; i < localeNames.length; i++ ) 
            {
                var nf:NumberFormatter = new NumberFormatter( localeNames[i] as String );
                trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName 
                    + "; actual: " + nf.actualLocaleIDName);
                trace( "Last Operation Status:" + nf.lastOperationStatus );   
            
                var numberString:String = nf.formatNumber(123456789.19); 
                trace( "Formatted Number:" + numberString);
                numberString = nf.formatInt(-123456789); 
                trace( "Formatted Int:" + numberString);
                numberString = nf.formatUint(123456789); 
                trace( "Formatted UInt:" + numberString);
            }
        }
    }
}

此示例中的结果可能因操作系统和用户首选项不同而异。

此示例执行以下操作：

1. 创建 NumberFormatter 对象。
2. 调用 NumberFormatter.parse() 方法以分析字符串并返回 NumberParseResult 对象。
3. 调用 NumberFormatter.parseNumber() 方法以分析字符串并返回一个 Number 值。

 
package {
      import flash.globalization.NumberFormatter;
      import flash.globalization.NumberParseResult;
      import flash.globalization.LastOperationStatus;
      import flash.globalization.LocaleID;

      public class NumberFormatterParseExample
      {
            public function NumberFormatterParseExample():void
            {
                var nf:NumberFormatter = new NumberFormatter( "en_US" );
                trace("LocaleID requested: " + nf.requestedLocaleIDName 
                    + "; actual: " + nf.actualLocaleIDName);
                trace( "Last Operation Status:" + nf.lastOperationStatus );  

                var inputNumberString:String = "123,567,89,0.254";
                var parseResult:NumberParseResult = nf.parse(inputNumberString);
                if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
                    trace("Parsed value:" + parseResult.value);
                }
                inputNumberString = "-123,567,89,0.254";
                var parsedNumber:Number = nf.parseNumber(inputNumberString);
                if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
                    trace("Parsed value:" + parsedNumber);
                }
            }
      }
}