Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

BigDecimal.toPlainString(): representación decimal sin exponente

Usa `toPlainString()` para escribir un `BigDecimal` sin notación exponencial. Al leer el texto, se recupera el valor numérico, pero no siempre la escala original.

Versión: Java SE 21

Sintaxis

public String toPlainString()

BigDecimal.toPlainString() es un método de instancia de java.math.BigDecimal. No tiene sobrecargas y se llama sin argumentos, por ejemplo, value.toPlainString(). Devuelve un String sin parte exponencial (E), sin redondear ni modificar el objeto.

Si la escala es positiva, coincide con el número de cifras tras el punto decimal: 1.2300 conserva sus ceros finales. Si la escala es cero o negativa, el resultado no lleva punto decimal: 1E+3 se convierte en 1000. El resultado no depende de la configuración regional: usa un punto como separador decimal y no agrupa las cifras.

Usa este método si necesitas texto sin exponente. new BigDecimal(text) recupera el mismo valor numérico, pero una escala negativa pasa a ser 0. Por eso compareTo() devuelve 0 aunque equals() pueda devolver false: equals() también comprueba la escala. Si necesitas recuperar tanto el valor como la escala original, usa toString(), que puede emplear notación exponencial.

Ejemplos

import java.math.BigDecimal;

public class Main {
    public static void main(String[] args) {
        BigDecimal original = new BigDecimal("1E+3");
        String plain = original.toPlainString();
        BigDecimal parsed = new BigDecimal(plain);

        System.out.println(original.toString());
        System.out.println(plain);
        System.out.println(new BigDecimal("1.2300").toPlainString());
        System.out.println(new BigDecimal("-1E-7").toPlainString());
        System.out.println(original.scale() + " -> " + parsed.scale());
        System.out.println(original.compareTo(parsed));
        System.out.println(original.equals(parsed));
    }
}

Resultado

1E+3
1000
1.2300
-0.0000001
-3 -> 0
0
false

Las dos primeras líneas comparan `toString()` con `toPlainString()`. Las dos siguientes muestran los ceros finales y un número negativo pequeño en valor absoluto. Al leer `1000`, la escala pasa de `-3` a `0`: la comparación numérica devuelve `0`, mientras que `equals()` devuelve `false`.

Lecciones relacionadas

  • Java · Lección 4 · Básico · Versión: 2
  • Java · Lección 6 · Básico · Versión: 2
  • Java · Lección 69 · Básico · Versión: 2

Fuentes