NumberFormat Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
<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- Herencia
- Derivado
- Atributos
Comentarios
<strong>[icu enhancement]</strong> ICU's replacement for java.text.NumberFormat. Los métodos, los campos y otras funcionalidades específicas de ICU se etiquetan como "<strong>[icu]</strong>".
<strong>IMPORTANT:</strong> New users are strong encouraged to see if NumberFormatter fits their use case. Aunque no está en desuso, esta clase, NumberFormat, solo se proporciona para la compatibilidad java.text.NumberFormat.
<hr>
NumberFormat es la clase base abstracta para todos los formatos de número. Esta clase proporciona la interfaz para dar formato y analizar números.
NumberFormat también proporciona métodos para determinar qué configuraciones regionales tienen formatos numéricos y cuáles son sus nombres.
NumberFormat le ayuda a formatear y analizar números para cualquier configuración regional. El código puede ser completamente independiente de las convenciones de configuración regional para puntos decimales, separadores de miles o incluso los dígitos decimales concretos usados, o si el formato de número es incluso decimal.
Para dar formato a un número para la configuración regional actual, use uno de los métodos de clase factory: <blockquote>
myString = NumberFormat.getInstance().format(myNumber);
</blockquote> Si da formato a varios números, es más eficaz obtener el formato y usarlo varias veces para que el sistema no tenga que capturar la información sobre el idioma local y las convenciones de país varias veces. <blockquote>
NumberFormat nf = NumberFormat.getInstance();
for (int i = 0; i < a.length; ++i) {
output.println(nf.format(myNumber[i]) + "; ");
}
</blockquote> Para dar formato a un número para una configuración regional diferente, especifíquelo en la llamada a getInstance.
<blockquote>
NumberFormat nf = NumberFormat.getInstance(Locale.FRENCH);
</blockquote> También puede usar para NumberFormat analizar números: <blockquote>
myNumber = nf.parse(myString);
</blockquote> Use getInstance o getNumberInstance para obtener el formato de número normal. Use getIntegerInstance para obtener un formato de número entero. Use getCurrencyInstance para obtener el formato de número de moneda. Y use getPercentInstance para obtener un formato para mostrar porcentajes. Algunos métodos de fábrica se encuentran en subclases de NumberFormat. Con este formato, una fracción como 0,53 se muestra como 53%.
A partir de ICU 4.2, puede usar getInstance() pasando un "style" como parámetro para obtener la instancia correcta. Por ejemplo, use getInstance(... NUMBERSTYLE) para obtener el formato de número normal, getInstance(... PERCENTSTYLE) para obtener un formato para mostrar porcentaje, getInstance(... SCIENTIFICSTYLE) para obtener un formato para mostrar el número científico, getInstance(... INTEGERSTYLE) para obtener un formato de número entero, getInstance(... CURRENCYSTYLE) para obtener el formato de número de moneda, en el que la moneda se representa mediante su símbolo, por ejemplo, "$3.00". getInstance(... ISOCURRENCYSTYLE) para obtener el formato de número de moneda, en el que la moneda se representa mediante su código ISO, por ejemplo "USD3.00". getInstance(... PLURALCURRENCYSTYLE) para obtener el formato de número de moneda, en el que la moneda se representa mediante su nombre completo en formato plural, por ejemplo, "3,00 DÓLARES ESTADOUNIDENSEs" o "1,00 DÓLAR ESTADOUNIDENSE".
También puede controlar la presentación de números con métodos como setMinimumFractionDigits. Si quieres tener aún más control sobre el formato o el análisis, o quieres proporcionar a los usuarios más control, puedes intentar convertir el objeto NumberFormat que obtienes de los métodos de fábrica a un DecimalFormat. Esto funcionará para la gran mayoría de configuraciones regionales; recuerde colocarlo en un try bloque en caso de que encuentre uno inusual.
NumberFormat está diseñado de forma que algunos controles funcionen para dar formato y otros funcionan para el análisis. A continuación se muestra la descripción detallada de cada uno de estos métodos de control,
setParseIntegerOnly : solo afecta al análisis, por ejemplo, si es true, "3456.78" -> 3456 (y deja la posición de análisis justo después de '6') si es false, "3456.78" -> 3456.78 (y deja la posición de análisis justo después de '8') Esto es independiente del formato. Si no desea mostrar un separador decimal donde podría no haber dígitos después del separador decimal, use setDecimalSeparatorAlwaysShown en DecimalFormat.
También puede usar formas de los parse métodos y con format y ParsePositionFieldPosition para permitirle: <ul><li> analizar progresivamente a través de partes de una cadena <li> alinean el separador decimal y otras áreas </ul> Por ejemplo, puede alinear números de dos maneras: <ol><li> Si usa una fuente monoespacial con espaciado para la alineación, puede pasar la FieldPosition llamada de formato, con field = INTEGER_FIELD. En la salida, getEndIndex se establecerá en el desplazamiento entre el último carácter del entero y el decimal. Agregue espacios (desiredSpaceCount - getEndIndex) en la parte frontal de la cadena.
<li> Si usa fuentes proporcionales, en lugar de rellenar con espacios, mida el ancho de la cadena en píxeles desde el principio a getEndIndex. A continuación, mueva el lápiz por (desiredPixelWidth - widthToAlignmentPoint) antes de dibujar el texto. También funciona donde no hay caracteres decimales, pero posiblemente caracteres adicionales al final, por ejemplo, con paréntesis en números negativos: "(12)" para -12.
</ol>
<h3>Synchronization</h3>
Por lo general, los formatos de número no se sincronizan. Se recomienda crear instancias de formato independientes para cada subproceso. Si varios subprocesos acceden a un formato simultáneamente, debe sincronizarse externamente.
<h4>DecimalFormat</h4>
DecimalFormat es la implementación concreta de NumberFormat y la API NumberFormat es esencialmente una abstracción de la API de DecimalFormat. Consulte DecimalFormat para obtener más información sobre esta API.
vea DecimalFormat see java.text.ChoiceFormat
Java documentación para android.icu.text.NumberFormat.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.
Constructores
| Nombre | Description |
|---|---|
| NumberFormat() |
Constructor vacío. |
| NumberFormat(IntPtr, JniHandleOwnership) |
<strong>[icu enhancement]</strong> ICU's replacement for |
Campos
| Nombre | Description |
|---|---|
| Accountingcurrencystyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar el estilo de moneda de formato que usa el símbolo de moneda para representar la moneda para la contabilidad, por ejemplo: "($3. |
| Cashcurrencystyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar el estilo de efectivo de moneda del formato que usa el código ISO de moneda para representar la moneda, por ejemplo: "NT$3" en lugar de "NT$3. |
| Currencystyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar el estilo de moneda general del formato. |
| FractionField |
Obsoletos.
Constante de campo utilizada para construir un objeto FieldPosition. |
| IntegerField |
Obsoletos.
Constante de campo utilizada para construir un objeto FieldPosition. |
| Integerstyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar un formato de estilo de número entero. |
| Isocurrencystyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar el estilo de moneda de formato que usa el código ISO de moneda para representar moneda, por ejemplo: "USD3. |
| Numberstyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar el estilo de número normal de formato. |
| Percentstyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar un estilo de formato para mostrar porcentaje. |
| Pluralcurrencystyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar el estilo de moneda de formato que usa el nombre largo de moneda con formato plural para representar moneda, por ejemplo, "3. |
| Scientificstyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar un estilo de formato para mostrar el número científico. |
| Standardcurrencystyle |
Obsoletos.
<strong>[icu]</strong> Constant para especificar el estilo de moneda de formato que usa el símbolo de moneda para representar la moneda, por ejemplo "$3. |
Propiedades
| Nombre | Description |
|---|---|
| Class |
Devuelve la clase en tiempo de ejecución de este |
| Currency |
Devuelve el |
| CurrencyInstance |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GroupingUsed |
Devuelve true si la agrupación se usa en este formato. -o bien- Establece si se usará o no la agrupación en este formato. |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| Instance |
<strong>NOTE:</strong> New users are strong encouraged to use |
| IntegerInstance |
<strong>NOTE:</strong> New users are strong encouraged to use |
| JniIdentityHashCode |
Obtiene el código hash de identidad asignado a este Java del mismo nivel por el tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| JniManagedPeerState |
<strong>[icu enhancement]</strong> ICU's replacement for |
| JniPeerMembers |
<strong>[icu enhancement]</strong> ICU's replacement for |
| MaximumFractionDigits |
Devuelve el número máximo de dígitos permitidos en la parte de fracción de un número. -o bien- Establece el número máximo de dígitos permitidos en la parte de fracción de un número. |
| MaximumIntegerDigits |
Devuelve el número máximo de dígitos permitidos en la parte entera de un número. -o bien- Establece el número máximo de dígitos permitidos en la parte entera de un número. |
| MinimumFractionDigits |
Devuelve el número mínimo de dígitos permitidos en la parte de fracción de un número. -o bien- Establece el número mínimo de dígitos permitidos en la parte de fracción de un número. |
| MinimumIntegerDigits |
Devuelve el número mínimo de dígitos permitidos en la parte entera de un número. -o bien- Establece el número mínimo de dígitos permitidos en la parte entera de un número. |
| NumberInstance |
<strong>NOTE:</strong> New users are strong encouraged to use |
| ParseIntegerOnly |
Devuelve true si este formato analizará los números solo como enteros. -o bien- Establece si se omitirá la parte de fracción de un número al analizar (el valor predeterminado es false). |
| ParseStrict |
<strong>[icu]</strong> Devuelve si el análisis estricto está en vigor. -o bien- <fuerte>[icu]</strong> Establece si el análisis estricto está en vigor. |
| PeerReference |
Obtiene la referencia de objeto JNI para este Java del mismo nivel. (Heredado de Object) |
| PercentInstance |
<strong>NOTE:</strong> New users are strong encouraged to use |
| RoundingMode |
Devuelve el modo de redondeo usado en este numberFormat. -o bien- Establezca el modo de redondeo usado en este NumberFormat. |
| ScientificInstance |
<strong>NOTE:</strong> New users are strong encouraged to use |
| ThresholdClass |
<strong>[icu enhancement]</strong> ICU's replacement for |
| ThresholdType |
<strong>[icu enhancement]</strong> ICU's replacement for |
Métodos
| Nombre | Description |
|---|---|
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de _Format) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
<strong>[icu enhancement]</strong> ICU's replacement for |
| Dispose() |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| Dispose(Boolean) |
Libera los recursos mantenidos por este Java del mismo nivel. (Heredado de Object) |
| DisposeUnlessReferenced() |
<strong>[icu enhancement]</strong> ICU's replacement for |
| Equals(Object) |
<strong>[icu enhancement]</strong> ICU's replacement for |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado 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 conveniencia para dar formato a un BigDecimal. |
| Format(BigDecimal) |
<método strong>[icu]</strong> Convenience para dar formato a un BigDecimal de ICU. |
| Format(BigInteger, StringBuffer, FieldPosition) |
<strong>[icu]</strong> Formats a BigInteger. |
| Format(BigInteger) |
<método strong>[icu]</strong> Convenience para dar formato a un BigInteger. |
| Format(CurrencyAmount, StringBuffer, FieldPosition) |
<strong>[icu]</strong> Formats a CurrencyAmount. |
| Format(CurrencyAmount) |
<método strong>[icu]</strong> Convenience para dar formato a CurrencyAmount. |
| Format(Double, StringBuffer, FieldPosition) |
Especialización del formato. |
| Format(Double) |
Especialización del formato. |
| Format(Int64, StringBuffer, FieldPosition) |
Especialización del formato. |
| Format(Int64) |
Especialización del formato. |
| Format(Object, StringBuffer, FieldPosition) |
Da formato a un número y anexa el texto resultante al búfer de cadena especificado. |
| Format(Object) |
Da formato a un objeto para generar una cadena. (Heredado de _Format) |
| FormatToCharacterIterator(Object) |
Da formato a un objeto que genera un |
| GetAvailableLocales() |
Devuelve la lista de configuraciones regionales para las que numberFormats están disponibles. |
| GetContext(DisplayContext+Type) |
[icu] Obtenga el valor displayContext del formateador para el displayContext.Type especificado, como CAPITALIZATION. |
| GetCurrencyInstance(Locale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetCurrencyInstance(ULocale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetHashCode() |
Devuelve un valor de código hash para el objeto . (Heredado de Object) |
| GetInstance(Locale, NumberFormatStyles) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetInstance(Locale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetInstance(NumberFormatStyles) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetInstance(ULocale, NumberFormatStyles) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetInstance(ULocale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetIntegerInstance(Locale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetIntegerInstance(ULocale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetNumberInstance(Locale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetNumberInstance(ULocale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetPattern(ULocale, Int32) |
Devuelve el patrón para la configuración regional y la elección proporcionadas. |
| GetPercentInstance(Locale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetPercentInstance(ULocale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetScientificInstance(Locale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| GetScientificInstance(ULocale) |
<strong>NOTE:</strong> New users are strong encouraged to use |
| JavaFinalize() |
Obsoletos.
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| Parse(String, ParsePosition) |
Devuelve un long si es posible (e. |
| Parse(String) |
Analiza el texto desde el principio de la cadena especificada para generar un número. |
| ParseCurrency(ICharSequence, ParsePosition) |
Analiza el texto de la cadena especificada como CurrencyAmount. |
| ParseCurrency(String, ParsePosition) |
Analiza el texto de la cadena especificada como CurrencyAmount. |
| ParseObject(String, ParsePosition) |
Analiza el texto de una cadena para generar un número. |
| ParseObject(String) |
Analiza el texto desde el principio de la cadena especificada para generar un objeto . (Heredado de _Format) |
| SetContext(DisplayContext) |
<strong>[icu]</strong> Establezca un valor DisplayContext determinado en el formateador, como CAPITALIZATION_FOR_STANDALONE. |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
<strong>[icu enhancement]</strong> ICU's replacement for |
| ToArray<T>() |
Crea una matriz administrada a partir de este contenedor de matriz Java. (Heredado de Object) |
| ToString() |
Devuelve una representación de cadena del objeto . (Heredado de Object) |
| UnregisterFromRuntime() |
Anula el registro de este Java del mismo nivel del tiempo de ejecución de interoperabilidad. (Heredado de Object) |
| Wait() |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser em notificado/em< o >em<interrumpido>/em<.><> (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Implementaciones de interfaz explícitas
| Nombre | Description |
|---|---|
| IJavaPeerable.Disposed() |
<strong>[icu enhancement]</strong> ICU's replacement for |
| IJavaPeerable.Finalized() |
<strong>[icu enhancement]</strong> ICU's replacement for |
| IJavaPeerable.JniObjectReferenceControlBlock |
<strong>[icu enhancement]</strong> ICU's replacement for |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
<strong>[icu enhancement]</strong> ICU's replacement for |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
<strong>[icu enhancement]</strong> ICU's replacement for |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
<strong>[icu enhancement]</strong> ICU's replacement for |
| IJavaPeerable.UnregisterFromRuntime() |
<strong>[icu enhancement]</strong> ICU's replacement for |
Métodos de extensión
| Nombre | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtiene el nombre JNI del tipo de la instancia |
| JavaAs<TResult>(IJavaPeerable) |
Intente coerción |
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
<strong>[icu enhancement]</strong> ICU's replacement for |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Intente coerción |