BigDecimal.Format Método

[Android.Runtime.Register("format", "(II)Ljava/lang/String;", "GetFormat_IIHandler", ApiSince=24)]
public virtual string? Format(int before, int after);

[<Android.Runtime.Register("format", "(II)Ljava/lang/String;", "GetFormat_IIHandler", ApiSince=24)>]
abstract member Format : int * int -> string
override this.Format : int * int -> string

Parámetros

Devoluciones

que String representa este BigDecimalobjeto , establecido según los parámetros especificados.

Atributos

RegisterAttribute

Comentarios

Devuelve la String representación de , BigDecimalmodificada por parámetros de diseño.

Este método se proporciona como primitivo para su uso por clases más sofisticadas, como DecimalFormat , que pueden aplicar la edición con distinción regional del resultado. El nivel de formato que proporciona es una parte necesaria de la clase BigDecimal, ya que es sensible a y debe seguir las reglas de cálculo y redondeo para la aritmética BigDecimal. Sin embargo, si la función se proporciona en otro lugar, se puede quitar de esta clase.

Los parámetros, para ambas formas del format método son todos de tipo int. Un valor de -1 para cualquier parámetro indica que se debe usar la acción o el valor predeterminado para ese parámetro.

Los parámetros before y after, especifican el número de caracteres que se van a usar para la parte entera y la parte decimal del resultado respectivamente. No se usa la notación exponencial. Si alguno de los parámetros es -1 (que indica la acción predeterminada), el número de caracteres utilizados será exactamente el número de caracteres que se necesitan para esa parte.

before debe ser un número positivo; si es mayor de lo necesario para contener la parte entera, esa parte se rellena a la izquierda con espacios en blanco a la longitud solicitada. Si before no es lo suficientemente grande como para contener la parte entera del número (incluido el signo, para números negativos), se produce una excepción.

after debe ser un número no negativo; si no es el mismo tamaño que la parte decimal del número, el número se redondea (o se extiende con ceros) que se ajustará. Especificar 0 para after hará que el número se redondee a un entero (es decir, no tendrá ninguna parte decimal o separador decimal). El método de redondeo será el valor predeterminado, MathContext.ROUND_HALF_UP.

Otros métodos de redondeo y el uso de la notación exponencial se pueden seleccionar mediante #format(int,int,int,int,int,int). El uso de la forma de dos parámetros del método tiene exactamente el mismo efecto que el uso del formulario de seis parámetros con los cuatro parámetros finales siendo -1.

Java documentación para android.icu.math.BigDecimal.format(int, int).

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.

[Android.Runtime.Register("format", "(IIIIII)Ljava/lang/String;", "GetFormat_IIIIIIHandler", ApiSince=24)]
public virtual string? Format(int before, int after, int explaces, int exdigits, int exformint, Android.Icu.Math.RoundOptions exround);

[<Android.Runtime.Register("format", "(IIIIII)Ljava/lang/String;", "GetFormat_IIIIIIHandler", ApiSince=24)>]
abstract member Format : int * int * int * int * int * Android.Icu.Math.RoundOptions -> string
override this.Format : int * int * int * int * int * Android.Icu.Math.RoundOptions -> string

Parámetros

Devoluciones

que String representa este BigDecimalobjeto , establecido según los parámetros especificados.

Atributos

RegisterAttribute

Comentarios

Devuelve la String representación de , BigDecimalmodificada por parámetros de diseño y permitiendo la notación exponencial.

Este método se proporciona como primitivo para su uso por clases más sofisticadas, como DecimalFormat , que pueden aplicar la edición con distinción regional del resultado. El nivel de formato que proporciona es una parte necesaria de la clase BigDecimal, ya que es sensible a y debe seguir las reglas de cálculo y redondeo para la aritmética BigDecimal. Sin embargo, si la función se proporciona en otro lugar, se puede quitar de esta clase.

Los parámetros son todos de tipo int. Un valor de -1 para cualquier parámetro indica que se debe usar la acción o el valor predeterminado para ese parámetro.

Los dos primeros parámetros (before y after) especifican el número de caracteres que se van a usar para la parte entero y la parte decimal del resultado respectivamente, tal como se define para #format(int,int). Si alguno de estos es -1 (que indica la acción predeterminada), el número de caracteres utilizados será exactamente el número de caracteres que se necesitan para esa parte.

Los parámetros restantes controlan el uso de notación exponencial y redondeo. Tres (explaces, exdigits, y exform) controlan la parte exponente del resultado. Como antes, se puede seleccionar la acción predeterminada para cualquiera de estos parámetros mediante el valor -1.

explaces debe ser un número positivo; establece el número de posiciones (dígitos después del signo del exponente) que se usará para cualquier parte exponente, el valor predeterminado (cuando explaces es -1) que se va a usar tantos como sea necesario. Si explaces no es -1, el espacio siempre está reservado para un exponente; si no es necesario (por ejemplo, si el exponente será 0), explacesse anexan +2 espacios en blanco al resultado. (Esto conserva la alineación vertical de números con formato similar en una fuente monoespacial). Si explaces no es -1 y no es lo suficientemente grande como para contener el exponente, se produce una excepción.

exdigits establece el punto de desencadenador para el uso de la notación exponencial. Si, antes de cualquier redondeo, el número de posiciones necesarias antes de que el separador decimal supere exdigits, o si el valor absoluto del resultado es menor que 0.000001, se usará el formato exponencial, siempre que exdigits se haya especificado. Cuando exdigits es -1, nunca se usará la notación exponencial. Si se especifica 0 para exdigits, la notación exponencial siempre se usa a menos que el exponente sea 0.

exform establece el formulario para la notación exponencial (si es necesario). Puede ser o MathContext#SCIENTIFICMathContext#ENGINEERING. Si se solicita el segundo, ingeniería, formulario, hasta tres dígitos (signo más, si es negativo) para la parte entera del resultado (before ). De lo contrario, solo se necesita un dígito (signo más, si es negativo).

Por último, el sexto argumento, exround, selecciona el algoritmo de redondeo que se va a usar y debe ser uno de los valores indicados por una constante pública en la MathContext clase cuyo nombre comienza por ROUND_ . El valor predeterminado (ROUND_HALF_UP) también se puede seleccionar mediante el valor -1, como antes.

El valor especial se puede usar para detectar si se descartan dígitos distintos de cero, si exround tiene este valor MathContext.ROUND_UNNECESSARY que si se descartaran dígitos distintos de cero (redondeados) durante el formato, se produce una ArithmeticException excepción .

Java documentación para android.icu.math.BigDecimal.format(int, int, int, int, int, int).

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.