Idioma

NumberFormat Classe

Definição

Namespace:
Android.Icu.Text
Assembly:
Mono.Android.dll

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

[Android.Runtime.Register("android/icu/text/NumberFormat", ApiSince=24, DoNotGenerateAcw=true)]
public abstract class NumberFormat : Android.Icu.Text.UFormat
[<Android.Runtime.Register("android/icu/text/NumberFormat", ApiSince=24, DoNotGenerateAcw=true)>]
type NumberFormat = class
    inherit UFormat
Herança
Object
JavaObject
Object
_Format
UFormat
NumberFormat
Derivado
Atributos
RegisterAttribute

Comentários

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.  Métodos, campos e outras funcionalidades específicas da UTI são rotulados como '<strong>[icu]</strong>'.

<strong>IMPORTANT:</strong> Novos usuários são fortemente incentivados a ver se se NumberFormatter ajustam ao seu caso de uso. Embora não tenha sido preterida, essa classe, NumberFormat, só é fornecida para compatibilidade java.text.NumberFormat. <hr>

NumberFormat é a classe base abstrata para todos os formatos de número. Essa classe fornece a interface para formatação e análise de números. NumberFormat também fornece métodos para determinar quais localidades têm formatos de número e quais são seus nomes.

NumberFormat ajuda você a formatar e analisar números para qualquer localidade. Seu código pode ser completamente independente das convenções de localidade para pontos decimais, separadores de milhares ou até mesmo os dígitos decimais específicos usados ou se o formato de número é mesmo decimal.

Para formatar um número para a Localidade atual, use um dos métodos de classe de fábrica: <blockquote>

myString = NumberFormat.getInstance().format(myNumber);

</blockquote> Se você estiver formatando vários números, é mais eficiente obter o formato e usá-lo várias vezes para que o sistema não precise buscar as informações sobre o idioma local e as convenções de país várias vezes. <blockquote>

NumberFormat nf = NumberFormat.getInstance();
            for (int i = 0; i &lt; a.length; ++i) {
                output.println(nf.format(myNumber[i]) + "; ");
            }

</blockquote> Para formatar um número para uma localidade diferente, especifique-o na chamada para getInstance. <blockquote>

NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);

</blockquote> Você também pode usar um NumberFormat para analisar números: <blockquote>

myNumber = nf.parse(myString);

</blockquote> Use getInstance ou getNumberInstance para obter o formato de número normal. Use getIntegerInstance para obter um formato de número inteiro. Use getCurrencyInstance para obter o formato de número de moeda. E use getPercentInstance para obter um formato para exibir porcentagens. Alguns métodos de fábrica são encontrados em subclasses de NumberFormat. Com esse formato, uma fração como 0,53 é exibida como 53%.

A partir da UTI 4.2, você pode usar getInstance() passando um "estilo" como parâmetro para obter a instância correta. Por exemplo, use getInstance(... NUMBERSTYLE) para obter o formato de número normal, getInstance(... PERCENTSTYLE) para obter um formato para exibir porcentagem, getInstance(... SCIENTIFICSTYLE) para obter um formato para exibir número científico, getInstance(... INTEGERSTYLE) para obter um formato de número inteiro, getInstance(... CURRENCYSTYLE) para obter o formato de número de moeda, no qual a moeda é representada por seu símbolo, por exemplo, "$3,00". getInstance(... ISOCURRENCYSTYLE) para obter o formato de número de moeda, no qual a moeda é representada por seu código ISO, por exemplo , "USD3.00". getInstance(... PLURALCURRENCYSTYLE) para obter o formato de número de moeda, no qual a moeda é representada por seu nome completo no formato plural, por exemplo, "3,00 dólares americanos" ou "1,00 dólar americano".

Você também pode controlar a exibição de números com métodos como setMinimumFractionDigits. Se você quiser ter ainda mais controle sobre o formato ou análise ou quiser dar mais controle aos usuários, tente converter os NumberFormat métodos de fábrica em um DecimalFormat. Isso funcionará para a grande maioria das localidades; lembre-se de colocá-lo em um try bloco no caso de encontrar um incomum.

NumberFormat foi projetado para que alguns controles funcionem para formatação e outros funcionem para análise. Veja a seguir a descrição detalhada de cada um desses métodos de controle,

setParseIntegerOnly: afeta apenas a análise, por exemplo, se verdadeiro, "3456,78" -> 3456 (e deixa a posição de análise logo após '6') se false, "3456.78" -> 3456,78 (e deixa a posição de análise logo após '8') Isso é independente da formatação. Se você não quiser mostrar um ponto decimal onde pode não haver dígitos após o ponto decimal, use setDecimalSeparatorAlwaysShown em DecimalFormat.

Você também pode usar formas e parseformat métodos com ParsePosition e FieldPosition permitir que você: <ul><li> analisar progressivamente por meio de partes de uma cadeia <de caracteres li> alinhar o ponto decimal e outras áreas </ul> Por exemplo, você pode alinhar números de duas maneiras: <ol><li> Se você estiver usando uma fonte monospaceada com espaçamento para alinhamento, você pode passar a FieldPosition chamada em seu formato, com field = INTEGER_FIELD. Na saída, getEndIndex será definido como o deslocamento entre o último caractere do inteiro e o decimal. Adicione espaços (desiredSpaceCount – getEndIndex) na frente da cadeia de caracteres.

<li> Se você estiver usando fontes proporcionais, em vez de preenchimento com espaços, meça a largura da cadeia de caracteres em pixels do início ao getEndIndex. Em seguida, mova a caneta por (desiredPixelWidth - widthToAlignmentPoint) antes de desenhar o texto. Ele também funciona onde não há caracteres decimais, mas possivelmente adicionais no final, por exemplo, com parênteses em números negativos: "(12)" para -12. </ol>

<Sincronização> h3</h3>

Os formatos de número geralmente não são sincronizados. É recomendável criar instâncias de formato separadas para cada thread. Se vários threads acessarem um formato simultaneamente, ele deverá ser sincronizado externamente.

<h4>DecimalFormat</h4>

DecimalFormat é a implementação concreta de NumberFormat e a API NumberFormat é essencialmente uma abstração da API de DecimalFormat. Consulte DecimalFormat para obter mais informações sobre essa API.

consulte DecimalFormat see java.text.ChoiceFormat

Java documentação para android.icu.text.NumberFormat.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Construtores

Nome Description
NumberFormat()

Construtor vazio.
NumberFormat(IntPtr, JniHandleOwnership)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

Campos

Nome Description
Accountingcurrencystyle
Obsoleto.

<strong>[icu]</strong> Constant to specify currency style of format which uses currency symbol to represent currency for accounting, for example: "($3.
Cashcurrencystyle
Obsoleto.

<strong>[icu]</strong> Constant to specify currency cash style of format which uses currency ISO code to represent currency, for example: "NT$3" instead of "NT$3.
Currencystyle
Obsoleto.

<strong>[icu]</strong> Constant para especificar o estilo de moeda geral do formato.
FractionField
Obsoleto.

Constante de campo usada para construir um objeto FieldPosition.
IntegerField
Obsoleto.

Constante de campo usada para construir um objeto FieldPosition.
Integerstyle
Obsoleto.

<strong>[icu]</strong> Constant para especificar um formato de estilo de número inteiro.
Isocurrencystyle
Obsoleto.

<strong>[icu]</strong> Constant para especificar o estilo de moeda de formato que usa o código ISO da moeda para representar a moeda, por exemplo: "USD3.
Numberstyle
Obsoleto.

<strong>[icu]</strong> Constant para especificar o estilo de número normal de formato.
Percentstyle
Obsoleto.

<strong>[icu]</strong> Constant para especificar um estilo de formato para exibir porcentagem.
Pluralcurrencystyle
Obsoleto.

<strong>[icu]</strong> Constant para especificar o estilo de moeda de formato que usa o nome longo da moeda com formato plural para representar a moeda, por exemplo, "3.
Scientificstyle
Obsoleto.

<strong>[icu]</strong> Constant para especificar um estilo de formato para exibir o número científico.
Standardcurrencystyle
Obsoleto.

<strong>[icu]</strong> Constant to specify currency style of format which uses currency symbol to represent currency, for example "$3.

Propriedades

Nome Description
Class

Retorna a classe de runtime deste Object.

(Herdado de Object)
Currency

Retorna o Currency objeto usado para exibir valores de moeda. -ou- Define o Currency objeto usado para exibir valores de moeda.
CurrencyInstance

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GroupingUsed

Retornará true se o agrupamento for usado nesse formato. -ou- Define se o agrupamento será usado ou não nesse formato.
Handle

O identificador para a instância subjacente do Android.

(Herdado de Object)
Instance

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
IntegerInstance

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
JniIdentityHashCode

Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade.

(Herdado de Object)
JniManagedPeerState

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
JniPeerMembers

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.
MaximumFractionDigits

Retorna o número máximo de dígitos permitido na parte fração de um número. -ou- Define o número máximo de dígitos permitido na fração de um número.
MaximumIntegerDigits

Retorna o número máximo de dígitos permitidos na parte inteira de um número. -ou- Define o número máximo de dígitos permitidos na parte inteira de um número.
MinimumFractionDigits

Retorna o número mínimo de dígitos permitidos na parte fração de um número. -ou- Define o número mínimo de dígitos permitidos na parte fração de um número.
MinimumIntegerDigits

Retorna o número mínimo de dígitos permitido na parte inteira de um número. -ou- Define o número mínimo de dígitos permitido na parte inteira de um número.
NumberInstance

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
ParseIntegerOnly

Retornará true se esse formato analisar números apenas como inteiros. -ou- Define se a fração de um número deve ser ignorada ao analisar (o padrão é false).
ParseStrict

<strong>[icu]</strong> Retorna se a análise estrita está em vigor. -ou- <strong>[icu]</strong> Define se a análise estrita está em vigor.
PeerReference

Obtém a referência de objeto JNI para este par Java.

(Herdado de Object)
PercentInstance

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
RoundingMode

Retorna o modo de arredondamento usado neste NumberFormat. -ou- Defina o modo de arredondamento usado neste NumberFormat.
ScientificInstance

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
ThresholdClass

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.
ThresholdType

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

Métodos

Nome Description
Clone()

Cria e retorna uma cópia desse objeto.

(Herdado de _Format)
Construct(JniObjectReference, JniObjectReferenceOptions)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
Dispose()

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
Dispose(Boolean)

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
DisposeUnlessReferenced()

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
Equals(Object)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
Equals(Object)

Indica se algum outro objeto é "igual a" este.

(Herdado de Object)
Format(BigDecimal, StringBuffer, FieldPosition)

<strong>[icu]</strong> Formats an ICU BigDecimal.
Format(BigDecimal, StringBuffer, FieldPosition)

<strong>[icu]</strong> Formats a BigDecimal.
Format(BigDecimal)

Método de conveniência para formatar um BigDecimal.
Format(BigDecimal)

<método strong>[icu]</strong> Convenience para formatar uma UTI BigDecimal.
Format(BigInteger, StringBuffer, FieldPosition)

<strong>[icu]</strong> Formats a BigInteger.
Format(BigInteger)

<método strong>[icu]</strong> Convenience para formatar um BigInteger.
Format(CurrencyAmount, StringBuffer, FieldPosition)

<strong>[icu]</strong> Formats a CurrencyAmount.
Format(CurrencyAmount)

<método strong>[icu]</strong> Convenience para formatar um CurrencyAmount.
Format(Double, StringBuffer, FieldPosition)

Especialização de formato.
Format(Double)

Especialização de formato.
Format(Int64, StringBuffer, FieldPosition)

Especialização de formato.
Format(Int64)

Especialização de formato.
Format(Object, StringBuffer, FieldPosition)

Formata um número e acrescenta o texto resultante ao buffer de cadeia de caracteres fornecido.
Format(Object)

Formata um objeto para produzir uma cadeia de caracteres.

(Herdado de _Format)
FormatToCharacterIterator(Object)

Formata um objeto que produz um AttributedCharacterIterator.

(Herdado de _Format)
GetAvailableLocales()

Retorna a lista de Localidades para as quais NumberFormats estão disponíveis.
GetContext(DisplayContext+Type)

[UTI] Obtenha o valor DisplayContext do formatador para o DisplayContext.Type especificado, como CAPITALIZATION.
GetCurrencyInstance(Locale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetCurrencyInstance(ULocale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetHashCode()

Retorna um valor de código hash para o objeto.

(Herdado de Object)
GetInstance(Locale, NumberFormatStyles)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetInstance(Locale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetInstance(NumberFormatStyles)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetInstance(ULocale, NumberFormatStyles)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetInstance(ULocale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetIntegerInstance(Locale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetIntegerInstance(ULocale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetNumberInstance(Locale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetNumberInstance(ULocale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetPattern(ULocale, Int32)

Retorna o padrão para a localidade e a escolha fornecidas.
GetPercentInstance(Locale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetPercentInstance(ULocale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetScientificInstance(Locale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
GetScientificInstance(ULocale)

<NOTA forte>:</os novos usuários fortes> são fortemente incentivados a usar NumberFormatter em vez de NumberFormat.
JavaFinalize()
Obsoleto.

Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto.

(Herdado de Object)
Notify()

Ativa um único thread que está aguardando no monitor deste objeto.

(Herdado de Object)
NotifyAll()

Ativa todos os threads que estão aguardando no monitor deste objeto.

(Herdado de Object)
Parse(String, ParsePosition)

Retorna um Long, se possível (e.
Parse(String)

Analisa o texto desde o início da cadeia de caracteres fornecida para produzir um número.
ParseCurrency(ICharSequence, ParsePosition)

Analisa o texto da cadeia de caracteres fornecida como CurrencyAmount.
ParseCurrency(String, ParsePosition)

Analisa o texto da cadeia de caracteres fornecida como CurrencyAmount.
ParseObject(String, ParsePosition)

Analisa o texto de uma cadeia de caracteres para produzir um número.
ParseObject(String)

Analisa o texto desde o início da cadeia de caracteres fornecida para produzir um objeto.

(Herdado de _Format)
SetContext(DisplayContext)

<strong>[icu]</strong> Definir um valor DisplayContext específico no formatador, como CAPITALIZATION_FOR_STANDALONE.
SetHandle(IntPtr, JniHandleOwnership)

Define a propriedade Handle

(Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
ToArray<T>()

Cria uma matriz gerenciada com base nesse wrapper de matriz Java.

(Herdado de Object)
ToString()

Retorna uma representação de cadeia de caracteres do objeto.

(Herdado de Object)
UnregisterFromRuntime()

Cancela o registro desse par Java do runtime de interoperabilidade.

(Herdado de Object)
Wait()

Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<>

(Herdado de Object)
Wait(Int64, Int32)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)
Wait(Int64)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)

Implantações explícitas de interface

Nome Description
IJavaPeerable.Disposed()

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
IJavaPeerable.Finalized()

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.

(Herdado de _Format)

Métodos de Extensão

Nome Description
GetJniTypeName(IJavaPeerable)

Obtém o nome JNI do tipo da instância self.
JavaAs<TResult>(IJavaPeerable)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)

Executa uma conversão de tipo marcada por runtime do Android.
JavaCast<TResult>(IJavaObject)

<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat.
TryJavaCast<TResult>(IJavaPeerable, TResult)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

Aplica-se a