CKTIS / Java
BigDecimal.valueOf — criar valores decimais
Conhece as três sobrecargas de `BigDecimal.valueOf` em Java 21 e percebe por que razão converter um `double` pode dar um resultado diferente do construtor.
Versão: Java SE 21
Sintaxe
import java.math.BigDecimal;
// Static overloads declared by java.math.BigDecimal:
public static BigDecimal valueOf(long val)
public static BigDecimal valueOf(long unscaledVal, int scale)
public static BigDecimal valueOf(double val)BigDecimal.valueOf é um método de fábrica estático da classe java.math.BigDecimal. Depois de adicionares import java.math.BigDecimal;, podes invocá-lo através do nome da classe, sem new. O Java SE 21 disponibiliza três sobrecargas.
valueOf(long) conserva o valor inteiro e define a escala como 0. valueOf(long unscaledVal, int scale) devolve o valor exato unscaledVal × 10^(−scale) com a escala indicada. Por exemplo, BigDecimal.valueOf(1250L, 2) produz 12.50 com escala 2. A escala pode ser negativa: BigDecimal.valueOf(125L, -2) tem valor numérico 12500 e escala -2.
Para um double d finito, valueOf(double) dá o mesmo resultado que new BigDecimal(Double.toString(d)): usa a representação decimal canónica de d em texto. Já new BigDecimal(d) representa em decimal o valor binário exato guardado em d. Por isso, BigDecimal.valueOf(0.1) dá exatamente 0.1, enquanto new BigDecimal(0.1) dá um valor ligeiramente superior. Ambas as formas lançam NumberFormatException para NaN e para ambos os infinitos.
A conversão não recupera precisão que já se perdeu. Em BigDecimal.valueOf(0.1 + 0.2), a adição é efetuada primeiro em double, pelo que o resultado é 0.30000000000000004. Se partires de um texto decimal exato, usa new BigDecimal("0.1") em vez de passar por double. Não existe uma sobrecarga BigDecimal.valueOf(String).
Exemplos
import java.math.BigDecimal;
public class Main {
public static void main(String[] args) {
double input = 0.1;
System.out.println(BigDecimal.valueOf(input).toPlainString());
System.out.println(new BigDecimal(input).toPlainString());
System.out.println(BigDecimal.valueOf(125L).toPlainString());
System.out.println(BigDecimal.valueOf(1250L, 2).toPlainString());
System.out.println(BigDecimal.valueOf(0.1 + 0.2).toPlainString());
}
}Resultado
0.1 0.1000000000000000055511151231257827021181583404541015625 125 12.50 0.30000000000000004
As duas primeiras linhas comparam o método de fábrica e o construtor para o mesmo `double`. A terceira e a quarta mostram as sobrecargas com inteiros e a última mostra o efeito de uma adição anterior em `double`. `toPlainString()` devolve a representação textual do valor sem notação exponencial e `println` escreve esse texto na consola.
Lições relacionadas
- Java · Lição 4 · Básico · Versão: 2
- Java · Lição 6 · Básico · Versão: 2