NumberFormatter  - AS3

El nombre del ID real de configuración regional utilizado por este objeto NumberFormatter.

Existen tres posibilidades para el valor del nombre, en función del sistema operativo y del valor del parámetro requestedLocaleIDName transferido al constructor Collator().

1. Si la configuración regional requerida no era LocaleID.DEFAULT y el sistema operativo admite la configuración regional requerida, el nombre devuelto es el mismo que la propiedad requestedLocaleIDName.
2. Si LocaleID.DEFAULT se ha utilizado como el valor del parámetro requestedLocaleIDName en el constructor, se utiliza el nombre de la configuración regional actual especificado por el sistema operativo del usuario. El valor de LocaleID.DEFAULT conserva la configuración personalizada del usuario en el sistema operativo. Transferir un valor explícito como el parámetro requestedLocaleIDName no necesariamente produce el mismo resultado que utilizar LocaleID.DEFAULT incluso si los dos ID de configuración regional son los mismos. El usuario podría haber personalizado los ajustes de la configuración regional de su equipo y, al solicitar un nombre ID de configuración regional explícito en lugar de utilizar LocaleID.DEFAULT, la aplicación no recuperaría dichos ajustes personalizados.
3. Si el sistema no admite el nombre de requestedLocaleIDName especificado en el constructor, se proporciona un nombre de ID de configuración regional de repuesto.

Elementos de API relacionados

El carácter de separador decimal se utiliza para aplicar formato o analizar números con parte decimal.

Esta propiedad está definida inicialmente según la configuración regional que esté seleccionada cuando se construye el objeto formateador.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the locale and operating system..

Elementos de API relacionados

Define el conjunto de caracteres de dígitos utilizados cuando se aplica formato a números.

Los distintos idiomas y regiones utilizan conjuntos de caracteres diferentes para representar los dígitos del 0 al 9. Esta propiedad define el conjunto de dígitos que se va a utilizar.

El valor de esta propiedad representa el valor Unicode para el dígito cero de un conjunto de dígitos decimales. Los valores válidos de esta propiedad se definen en la clase NationalDigitsType.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the locale and operating system..

Elementos de API relacionados

El número máximo de dígitos que pueden aparecer después del separador decimal.

Los números se redondean al número de dígitos especificado en esta propiedad. El esquema de redondeo varía en función del sistema operativo del usuario.

Cuando la propiedad trailingZeros se establece en true, la parte fraccionaria del número (después de la coma decimal) se rellena con ceros hasta que su longitud coincida con el valor de esta propiedad fractionalDigits.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es 0.

Elementos de API relacionados

Describe la colocación de los separadores de agrupación dentro de la cadena de número con formato.

Cuando la propiedad useGrouping se establece como true, la propiedad groupingPattern se utiliza para definir la ubicación y el patrón utilizados para el separador de agrupación.

El patrón de agrupación se define como una cadena que contiene los números separados por puntos y comas y, opcionalmente, pueden terminar con un asterisco. Por ejemplo: "3;2;*". Cada número de la cadena representa el número de dígitos de un grupo. El separador de agrupación se coloca antes de cada grupo de dígitos. Un asterisco al final de la cadena indica que los grupos con ese número de dígitos se deben repetir para el resto de la cadena con formato. Si no hay asterisco, no hay grupos ni separadores adicionales para el resto de la cadena con formato.

El primer número de la cadena corresponde al primer grupo de dígitos a la izquierda del separador decimal. Los siguientes números definen el número de dígitos de los grupos subsiguientes a la izquierda. Por lo tanto, la cadena "3;2;*" indica que el separador de agrupación se coloca después del primer grupo de 3 dígitos, seguido de grupos de 2 dígitos. Por ejemplo: 98,76,54,321

La tabla siguiente muestra ejemplos de formato del número 123456789.12 con varios patrones de agrupación. El separador de agrupación es una coma y el separador decimal es un punto.

Sólo se puede definir un número de tamaños de agrupación. En algunos sistemas operativos, los patrones de agrupación solamente puede contener dos números más un asterisco. Otros sistemas operativos admiten hasta cuatro números y un asterisco. Para los patrones sin un asterisco, algunos sistemas operativos sólo admiten un número, mientras que otros admiten hasta tres. Si se supera el número máximo de elementos de patrón de agrupación, los elementos adicionales se pasan por alto y la propiedad lastOperationStatus se establece como se describe a continuación.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Elementos de API relacionados

El carácter o la cadena utilizado para el separador de agrupación.

El valor de esta propiedad se utiliza como separador de agrupación cuando el número con formato de la propiedad useGrouping se establece como true. Esta propiedad está definida inicialmente según la configuración regional que esté seleccionada cuando se construye el objeto formateador.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the locale and operating system..

Elementos de API relacionados

El estado de operación anterior que este objeto NumberFormatter ha realizado. La propiedad lastOperationStatus se establece siempre que se llame al constructor o a un método de esta clase, o si se establece otra propiedad. Para conocer los valores posibles, consulte la descripción de cada método.

Elementos de API relacionados

Especifica si se incluye un cero a la izquierda en un número con formato cuando no hay dígitos enteros a la izquierda del separador decimal.

Cuando esta propiedad se establece en true, se incluye un cero a la izquierda del separador decimal cuando haya valores numéricos con formato entre -1.0 y 1.0. Si esta propiedad se establece en false no se incluye ningún un cero a la izquierda.

Por ejemplo, si el número es 0.321 y esta propiedad se establece true, el cero a la izquierda sí se incluye en la cadena con formato. Si la propiedad se establece como false, no se incluye ningún cero a la izquierda. En ese caso, la cadena sólo incluye el separador decimal seguido de los dígitos decimales, es decir, .321.

La tabla siguiente muestra ejemplos de cómo se aplica formato a números en función de los valores de esta propiedad y las propiedades fractionalDigits y trailingZeros relacionadas.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the locale and operating system..

Elementos de API relacionados

Un valor numérico que indica un patrón de formato para números negativos. Este patrón define la ubicación del símbolo negativo o el paréntesis en relación con la parte numérica del número con formato.

En la tabla siguiente se resumen los posibles formatos de números negativos. Cuando se aplica formato a un número negativo, el signo menos se sustituye por el valor de la propiedad negativeSymbol y el carécter 'n' se sustituye por el valor numérico con formato.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the locale and operating system..

Elementos de API relacionados

El símbolo negativo que se va a utilizar al aplicar formato a valores negativos.

Este símbolo se utiliza con el formato de número negativo cuando se aplica formato a un número que es menor que cero. No se utiliza en formatos de números negativos que no incluyen un signo negativo (por ejemplo, cuando los números negativos aparecen entre paréntesis).

Esta propiedad se establece en un valor predeterminado para la configuración regional real seleccionada cuando se construye este formateador. Se puede establecer con un valor para anular la configuración predeterminada.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Elementos de API relacionados

El nombre del ID de configuración regional requerido que se transfirió al constructor de este objeto NumberFormatter.

Si se ha utilizado el valor LocaleID.DEFAULT, el nombre devuelto es "i-default". La configuración regional real que se utiliza puede ser diferente de la configuración regional requerida cuando cuando se aplica una configuración regional de repuesto. El nombre de la configuración regional real se puede recuperar usando la propiedad actualLocaleIDName.

Elementos de API relacionados

Especifica si se incluyen ceros a la derecha en un número con formato.

Cuando esta propiedad se establece en true, se incluyen ceros a la derecha en la parte fraccionaria del número con formato hasta el límite especificado por la propiedad fractionalDigits. Cuando esta propiedad se establece en false, no se muestra ningún cero a la derecha.

Por ejemplo, si el valor numérico es 123.4, esta propiedad se establece en true, y la propiedad fractionalDigits se establece en 3, la cadena con formato mostrará ceros a la derecha, es decir, 123.400 . Si esta propiedad es false, no se incluirán ceros a laderecha y la cadena muestra simplemente el separador decimal seguido de los dígitos decimales sin ceros añadidos, es decir, 123,4 .

La tabla siguiente muestra ejemplos de cómo se aplica formato a valores numéricos en función de los valores de esta propiedad y las propiedades fractionalDigits y leadingZero relacionadas.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

El valor predeterminado es dependent on the locale and operating system..

Elementos de API relacionados

Permite el uso del separador de agrupación cuando se aplica formato a números.

Cuando la propiedad useGrouping se establece en true, los dígitos se agrupan y se delimitan mediante el carácter separador de agrupación. Por ejemplo: 123.456.789,22

Cuando la propiedad useGrouping se establece en false, los dígitos no se agrupan ni se separan. Por ejemplo: 123456789.22

El símbolo que se va a utilizar como separador de agrupación está definido por la propiedad groupingSeparator. El número de dígitos entre los separadores de agrupamiento está definido por la propiedad groupingPattern.

Cuando se asigna un valor a esta propiedad y no hay errores ni advertencias, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Elementos de API relacionados

Construye un nuevo objeto NumberFormatter para dar formato a números según las convenciones de una configuración regional determinada.

Este constructor determina si el sistema operativo actual admite el nombre del ID solicitado configuración regional. Si no se admite, se utilizará en su lugar una configuración regional repuesto. Si se utiliza una configuración regional de repuesto, la propiedad lastOperationStatus indica el tipo de repuesto y la propiedad actualLocaleIDName contiene el nombre del ID de configuración regional de repuesto.

Para dar formato a partir de las preferencias del sistema operativo actuales del usuario, transfiera el valor LocaleID.DEFAULT del parámetro requestedLocaleIDName al constructor.

Cuando el constructor se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

Cuando nombre del ID de la configuración regional no está disponible, lastOperationStatus se establece en uno de los valores siguientes:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Si esta clase no se admite en el sistema operativo actual, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.UNSUPPORTED_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Para obtener información detallada sobre las advertencias que aparecen en la lista anterior y sobre otros valores posibles de la proipedad lastOperationStatus, consulte las descripciones de la clase LastOperationStatus.

Elementos de API relacionados

Da formato a un valor int. Esta función es equivalente al método formatNumber() con la salvedad de que toma un valor int. Si el valor transferido es demasiado grande o pequeño, como un valor mayor que 1.72e308 o menor que 1.72e-308, esta función devuelve 0.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

Elementos de API relacionados

Da formato a un valor Number.

Esta función da formato al número basado en los valores de propiedad de formateador. Si las propiedades no se modifican tras la creación del objeto numberFormatter, se da formato a los números según las convenciones específicas de la configuración regional proporcionadas por el sistema operativo de la configuración regional identificada por actualLocaleIDName. Para personalizar el formato, las propiedades se puede modificar para controlar determinados aspectos de aplicación de formato a un número.

Con esta función se puede dar formato a números muy grandes y muy pequeños. Sin embargo, el número de dígitos significativos está limitado a la precisión proporcionada por el objeto Number. No se admite notación científica.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

Elementos de API relacionados

Da formato a un valor uint. Esta función es equivalente al método formatNumber() con la salvedad de que toma un valor uint. Si el valor transferido es demasiado grande, como un valor mayor que 1.72e308, esta función devuelve 0.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

Elementos de API relacionados

Muestra una lista de todos los nombres de ID de configuración regional admitidos por esta clase.

Si esta clase no se admite en el sistema operativo actual, este método devuelve un valor null.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Analiza una cadena y devuelve un objeto NumberParseResult que contiene los elementos analizados.

El objeto NumberParseResult contiene el valor del primer número encontrado en la cadena de entrada, el índice de inicio para el número en la cadena y el índice del primer carácter después del número en la cadena.

Si la cadena no contiene un número, el valor de la propiedad NumberParseResult se establece como NaN y las propiedades startIndex y endIndex se establecen en el valor hexadecimal 0x7fffffff.

Esta función utiliza el valor de la propiedad decimalSeparator para determinar la parte de la número que contiene dígitos fraccionarios, la propiedad groupingSeparator para determinar los caracteres permitidos en los dígitos del número y la propiedad negativeNumberFormat para controlar cómo se representan los valores negativos.

La tabla siguiente identifica el resultado de cadenas analizadas para los distintos valores de NegativeNumberFormat:

Sólo se permite un espacio en blanco entre el número y el signo menos o un paréntesis.

Otras propiedades se omiten al determinar un número válido. Concretamente, se omite el valor de la propiedad digitsType y los dígitos pueden ir desde cualquiera de los conjuntos de dígitos que se enumeran en la clase NationalDigitsType. Los valores de las propiedades groupingPattern y useGrouping no influyen en la análisis del número.

Si los números van precedidos o seguidos en la cadena por un signo '+', el signo más se trata como un carácter que no forma parte del número.

Esta función no analiza cadenas que contengan números en notación científica (p. ej., 1.23e40).

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

Elementos de API relacionados

 
         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"
         

Analiza una cadena que contiene sólo dígitos y caracteres de espacios en blanco opcionales y devuelve un número. Si la cadena no empieza por un número o si contiene caracteres distintos de espacios en blanco que no forman parte del número, este método devuelve NaN. El espacio en blanco antes o después de los dígitos numéricos se omite. Un carácter de espacio en blanco es un carácter que tiene una propiedad de separador de espacio (Zs) en la base de datos de caracteres Unicode (consulte http://www.unicode.org/ucd/).

Si el dígito numérico va precedido o seguido de un signo más '+' se trata como caracter distinto de espacio en blanco. El valor devuelto es NaN.

Consulte la descripción de la función parse para obtener más información sobre análisis de números y lo que constituye un número válido.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

Elementos de API relacionados

Este ejemplo utiliza las siguientes configuraciones regionales: configuración regional predeterminada del sistema operativo del usuario para formato de números, japonés (Japón), inglés (EE.UU.) y francés (Francia). El ejemplo utiliza el miembro estático LocaleID.DEFAULT para solicitar la configuración regional predeterminada del sistema operativo.

Tenga en cuenta que los resultados de este ejemplo pueden variar en función del sistema operativo y las preferencias del usuario.

El ejemplo realiza las acciones siguientes para cada configuración regional de la lista:

1. Crea un objeto NumberFormatter.
2. Da formato al mismo valor que un número, un entero y un entero sin signo, y muestra los resultados.

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

Tenga en cuenta que los resultados de este ejemplo pueden variar en función del sistema operativo y las preferencias del usuario.

En este ejemplo se muestran los siguientes procedimientos:

1. Crea un objeto NumberFormatter.
2. Llama al método NumberFormatter.parse() para analizar la cadena y devuelve un objeto NumberParseResult.
3. Llama al método NumberFormatter.parseNumber() para analizar la cadena y devuelve un valor de 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);
                }
            }
      }
}