NumberFormatter  - AS3

O nome do ID real de local usado por este objeto de NumberFormatter.

Há três possibilidades para o valor de nome, dependendo do sistema operacional e do valor do parâmetro requestedLocaleIDName passado ao construtor Collator().

1. Se o idioma solicitado não for LocaleID.DEFAULT e o sistema operacional oferecer suporte para o idioma solicitado, o nome retornado será o mesmo da propriedade requestedLocaleIDName.
2. Se LocaleID.DEFAULT foi usado como o valor do parâmetro requestedLocaleIDName para o construtor, o nome do idioma atual especificado pelo sistema operacional do usuário será usado. O valor LocaleID.DEFAULT preserva a configuração personalizada do usuário no sistema operacional. Observe que a passagem de um valor explícito como o parâmetrorequestedLocaleIDName não tem necessariamente o mesmo resultado que o uso de LocaleID.DEFAULT, mesmo que os dois nomes de ID de idioma sejam iguais. O usuário poderia ter personalizado as configurações de idioma de sua máquina e, ao solicitar um nome de ID de idioma explícito, em vez de usar LocaleID.DEFAULT, o aplicativo não recuperaria as configurações personalizadas.
3. Se o sistema não suporta o requestedLocaleIDName especificado no construtor, é fornecido um nome de ID de local de retrocesso.

Elementos da API relacionados

O caractere de separador decimal usado para formatar ou analisar números que têm uma parte decimal.

Esta propriedade é inicialmente estabelecida com base na localidade que é selecionada quando o objeto de formatter é construído.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é dependent on the locale and operating system..

Elementos da API relacionados

Define o conjunto de caracteres de dígitos a serem usados ao formatar números.

Idiomas e regiões diferentes usam cojuntos de caracteres diferentes para representar os dígitos de 0 a 9. Esta propriedade define o conjunto de dígitos a serem usados.

O valor desta propriedade representa o valor Unicode do dígito nulo de um conjunto de dígitos decimais. Os valores válidos desta propriedade são definidos na classe NationalDigitsType.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é dependent on the locale and operating system..

Elementos da API relacionados

O número máximo de dígitos que podem aparecer depois do separador decimal.

Os números serão arredondados para o número de dígitos especificados por esta propriedade. O esquema de arredondamento varia de acordo com o sistema operacional do usuário.

Quando a propriedade trailingZeros é definida como true, a porção fracionária do número (depois do ponto decimal) será preenchida com zeros à direita até que o seu comprimento corresponda ao valor desta propriedade fractionalDigits.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é 0.

Elementos da API relacionados

Descreve a posição dos separadores de agrupamento dentro da string numérica formatada.

Quando a propriedade useGrouping é definida como true, a propriedade groupingPattern é usada para definir a posição e o padrão usados pelo separador de agrupamento.

O padrão de agrupamento é definido como uma string que contém números separados por pontos-e-vírgulas e, opcionalmente, pode terminar com um asterisco. Por exemplo: "3;2;*". Cada número da string representa a quantidade de dígitos de um grupo. O separador de agrupamento é posicionado antes de cada grupo de dígitos. Um asterisco no fim da string indica que os grupos com aquele número de dígitos devem ser repetidos para o resto da string formatada. Se não houver nenhum asterisco, não haverá nenhum grupo adicional ou separadores para o resto da string formatada.

O primeiro número da string corresponde ao primeiro grupo de dígitos à esquerda do separador decimal. Os números subsequentes definem a quantidade de dígitos nos grupos subsequentes à esquerda. Assim a string "3; 2; *" indica que um separador de agrupamento é inserido depois do primeiro grupo de 3 dígitos, seguidos por grupos de 2 dígitos. Por exemplo: 98,76,54,321

A seguinte tabela mostra exemplos de formatação do número 123456789.12 com vários padrões de agrupamento. O separador de agrupamento é uma vírgula e o separador decimal é um ponto.

Só um número limitado de tamanhos de agrupamento pode ser definido. Em alguns sistemas operacionais, os padrões de agrupamento só podem conter dois números e um asterisco. Outros sistemas operacionais podem dar suporte a até quatro números e um asterisco. Para padrões sem um asterisco, alguns sistemas operacionais só suportam um número enquanto os outros suportam até três números. Se o número máximo de elementos de agrupamento padrão for excedido, os elementos adicionais não serão ignorados, e a propriedade lastOperationStatus será definida como descrito abaixo.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Elementos da API relacionados

O caractere ou a string usados para o separador de agrupamento.

O valor desta propriedade é usado como o separador de agrupamento ao formatar números com a propriedade useGrouping definida como true. Esta propriedade é inicialmente estabelecida com base na localidade que é selecionada quando o objeto de formatter é construído.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é dependent on the locale and operating system..

Elementos da API relacionados

O status da operação anterior que este objeto NumberFormatter executou. A propriedade lastOperationStatus é configurada sempre que se invoca o construtor ou um método desta classe ou que outra propriedade é configurada. Para ver os valores possíveis, consulte a descrição de cada método.

Elementos da API relacionados

Especifica se um zero à esquerda estará incluído em um número formatado quando não houver nenhum dígito de número inteiro à esquerda do separador decimal.

Quando esta propriedade é definida como true, é incluído um zero à esquerda do separador decimal ao formatar valores numéricos entre -1.0 e 1.0. Quando esta propriedade é definida como false, não se inclui o zero à esquerda.

Por exemplo se o número for 0.321 e esta propriedade for definida como true, então o zero à esquerda estará incluído na string formatada. Se a propriedade for definida como false, o zero à esquerda não será incluído. Neste caso, a cadeia incluiria somente o separador decimal seguido pelos dígitos decimais, como .321.

A seguinte tabela mostra exemplos de como os números são formatados com base nos valores desta propriedade e as propriedades relacionadas fractionalDigits e trailingZeros.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é dependent on the locale and operating system..

Elementos da API relacionados

Um valor numérico que indica um padrão de formatação para números negativos. Este padrão define o local do símbolo negativo ou parênteses em relação à porção numérica do número formatado.

A seguinte tabela resume os formatos possíveis de números negativos. Quando um número negativo é formatado, o sinal de menos do formato é substituído pelo valor da propriedade negativeSymbol e o caractere "n" é substituído pelo valor numérico formatado.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é dependent on the locale and operating system..

Elementos da API relacionados

O símbolo negativo a ser usado ao formatar valores negativos.

Este símbolo será usado em conjunto com o formato de número negativo ao formatar um número que menor que zero. Não é usado em formatos de número negativo que não incluem um sinal negativo (p. ex. quando os números negativos ficam entre parênteses).

Esta propriedade será definida como um valor padrão do idioma real selecionado quando este formatador for construído. Pode ser feito com um valor para sobrescrever o configuração padrão.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Elementos da API relacionados

O nome do ID de localidade solicitada que foi passado ao construtor deste objeto de NumberFormatter.

Se o valor LocaleID.DEFAULT tiver sido usado, então o nome retornado será "i-default". A localidade real usada pode diferenciar-se da localidade solicitada quando uma localidade de retorno é aplicada. É possível recuperar nome do local real pode ser recuperado usando o actualLocaleIDName propriedade.

Elementos da API relacionados

Especifica se os zeros à direita estarão incluídos em um número formatado.

Quando esta propriedade é definida como true, os zeros à direita são incluídos na parte fracionária do número formatado, até o limite especificado pela propriedade fractionalDigits. Quando esta propriedade é definida como false, nenhum zero à direita será exibido.

Por exemplo se o valor numérico for 123.4, e esta propriedade for definida como verdadeira, e a propriedade fractionalDigits for definida como 3, a cadeia formatada mostraria zeros à direita, como 123.400. Se esta propriedade for false, os zeros à direita não serão incluídos, e a string mostrará somente o separador decimal seguido pelos dígitos decimais diferentes de zero, como 123.4.

A seguinte tabela mostra exemplos de como os valores numéricos são formatados com base nos valores desta propriedade e as propriedades relacionadas fractionalDigits e leadingZero.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é dependent on the locale and operating system..

Elementos da API relacionados

Ativa o uso do separador de agrupamento ao formatar números.

Quando a propriedade useGrouping é definida como true, os dígitos são agrupados e delimitados pelo caractere de separador de agrupamento. Por exemplo: 123,456,789.22

Quando a propriedade useGrouping é definida como false, os dígitos não são agrupados ou separados. Por exemplo: 123456789.22

O símbolo a ser usado como um separador de agrupamento é definido pela propriedade groupingSeparator. O número de dígitos entre separadores de agrupamento é definido pela propriedade groupingPattern.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Elementos da API relacionados

Constrói um novo objeto de NumberFormatter para formatar números segundo as convenções de um determinado local.

Este construtor determinará se o sistema operacional atual suporta o local o nome de ID de localidade solicitado. Se não suportar, será usado um idioma de retorno. Se um idioma de retorno for usada, a propriedade lastOperationStatus indicará o tipo de retorno, e a propriedade actualLocaleIDName conterá o nome do ID do idioma de retorno.

Para formatar de acordo com as preferências de sistema operacional atuais do usuário, passe o valor LocaleID.DEFAULT no parâmetro requestedLocaleIDName para o construtor.

Quando o construtor conclui com sucesso, o lastOperationStatus a propriedade é definida como:

• LastOperationStatus.NO_ERROR

Quando o nome de ID de local solicitado não está disponível, lastOperationStatus é configurado como uma das alternativas a seguir:

• LastOperationStatus. USING_FALLBACK_WARNING
• LastOperationStatus. USING_DEFAULT_WARNING

Se esta classe não for suportada no sistema operacional atual, a propriedade lastOperationStatus for definida como:

• LastOperationStatus. UNSUPPORTED_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Para ver detalhes sobre os avisos citados acima e outros valores possíveis da propriedade lastOperationStatus, consulte as descrições na classe LastOperationStatus.

Elementos da API relacionados

Formata um valor de int. Esta função é equivalente ao método formatNumber() exceto que ele toma um valor int. Se o valor transmitido for muito grande ou pequeno, tal como um valor maior do que 1.72e308 ou menor que 1.72e-308, então esta função retornará 0.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Formata um Valor numérico.

Esta função formata o número com base nos valores de propriedade formatter. Se as propriedades não forem modificadas depois de o objeto numberFormatter ser criado, os números serão formatados segundo as convenções de idiomas específicas fornecidas pelo sistema operacional para o idioma identificado por actualLocaleIDName. Para personalizar o formato, as propriedades podem ser alteradas para controlar aspectos específicos de formatação de um número.

Números muito grandes e números de magnitude muito pequena podem ser formatados com esta função. Contudo, o número de dígitos significativos é limitado à precisão fornecida pelo objeto Number. A notação científica não é suportada.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Formata um valor de uint. Esta função é equivalente ao método formatNumber() exceto que ele toma uma uint. Se o valor passado for muito grande, tal como um valor maior do que 1.72e308, então esta função retornará 0.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Lista todos os nomes de ID de local suportados por essa classe.

Se esta classe não for suportada no sistema operacional atual, este método retornará um valor nulo.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Analisa uma string e retorna um objeto de NumberParseResult que contém os elementos analisados.

O objeto NumberParseResult contém o valor do primeiro número localizado na cadeia de entrada, o índice inicial do número dentro da cadeia, e o índice do primeiro caractere depois do número na cadeia.

Se a string não contiver um número, a propriedade de valor do NumberParseResult será definida como NaN e as propriedades startIndex e endIndex serão definidas como o valor hexadecimal 0x7fffffff.

Esta função usa o valor da propriedade decimalSeparator para determinar a porção do número que contém dígitos fracionários, e a propriedade groupingSeparator para determinar que caracteres são permitidos dentro dos dígitos de um número, e a propriedade negativeNumberFormat para controlar como os valores negativos são representados.

A seguinte tabela identifica o resultado de cadeias analisados para vários valores de NegativeNumberFormat:

Observe que somente um espaço em branco é permitido entre o número e o sinal de menos ou parênteses.

Outras propriedades não são ignoradas ao determinar um número válido. Especificamente o valor da propriedade digitsType não é ignorado e os dígitos podem ser de algum dos jogos de dígito que são enumerados na classe NationalDigitsType. Os valores das propriedades groupingPattern e useGrouping não influenciam a análise do número.

Se os números forem precedidos ou seguidos na cadeia por um sinal de mais "+", o sinal de mais será tratado como um caractere que não faz parte do número.

Esta função não analisa strings que contêm números em notação científica (e.g. 1.23e40).

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da 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"
         

Analisa uma string que contém só dígitos e caracteres de espaço em branco opcionais e retorna um Número. Se a cadeia não começar com um número ou contiver caracteres que não forem espaço em branco que não são parte do número, então este método retornará NaN. O espaço em branco antes ou depois dos dígitos numéricos não é ignorado. Um caractere de espaço em branco é um caractere que tem uma propriedade Separador de Espaço (Zs) no Banco de Dados de Caracteres Unicode (veja http://www.unicode.org/ucd/).

Se o dígito numérico for precedido ou seguido de um sinal de adição, '+' , será tratado como um caractere diferente do espaço em branco. O valor de retorno é NaN.

Ver a descrição da função de análise para obter mais informações sobre a análise de número e o que constitui um número válido.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Este exemplo usa os seguintes idiomas: idioma padrão do sistema operacional para a formatação de números, japonês (Japão), inglês (EUA) e francês (França). O exemplo usa o membro estático LocaleID.DEFAULT para solicitar o idioma padrão do sistema operacional.

Os resultados deste exemplo serão diferentes de acordo com as preferências do usuário e o sistema operacional.

Este exemplo realiza o seguinte para cada idioma na lista:

1. Cria um objeto NumberFormatter.
2. Formata o mesmo valor como um Número, um número inteiro, e um inteiro não assinado, e exibe os 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);
            }
        }
    }
}

Os resultados deste exemplo serão diferentes de acordo com as preferências do usuário e o sistema operacional.

Este exemplo faz o seguinte:

1. Cria um objeto NumberFormatter.
2. Chama o método NumberFormatter.parse() para analisar a string e retornar um objeto de NumberParseResult.
3. Chama o método NumberFormatter.parseNumber() para analisar a string e devolver um valor numérico.

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