CKTIS / Java
Number.doubleValue() — converter para double
O método devolve o valor de um objeto `Number` como um `double` primitivo. A exatidão depende do subtipo real do objeto e de o valor poder ser representado exatamente como `double`.
Versão: Java SE 21
Sintaxe
public abstract double doubleValue();
// n is a non-null Number reference:
double value = n.doubleValue();Number.doubleValue() é um método de instância abstrato, sem argumentos, declarado em java.lang.Number. A chamada n.doubleValue() devolve um valor do tipo primitivo double, não um objeto Double. Mesmo quando n é declarado como Number, o Java usa a implementação da classe real do objeto.
Todos os valores Integer são convertidos com exatidão, mas alguns valores Long têm de ser arredondados. A conversão de um BigDecimal pode perder precisão mesmo quando o resultado é finito e pode devolver um infinito com o sinal adequado se o valor absoluto for demasiado grande. Se o cálculo tiver de ser exato, não passes para double quando este tipo não puder representar o valor exatamente.
Se n for null, a chamada lança uma NullPointerException. O método converte o valor de um objeto numérico existente; não interpreta texto. Para ler um número a partir de uma String, usa Double.parseDouble(String).
Exemplos
public class NumberDoubleValueDemo {
public static void main(String[] args) {
Number small = Integer.valueOf(42);
double value = small.doubleValue();
System.out.println(value);
System.out.println(value * 2);
long original = 9_007_199_254_740_993L;
Number large = Long.valueOf(original);
double rounded = large.doubleValue();
System.out.println(original);
System.out.println((long) rounded);
}
}Resultado
42.0 84.0 9007199254740993 9007199254740992
As duas primeiras linhas mostram o valor exato `42.0` antes da multiplicação por `2` e o resultado `84.0`. As duas últimas comparam o `long` original com o resultado da conversão para `double` e de volta para `long`. A conversão explícita `(long)` permite apresentar aqui o valor arredondado como um inteiro, mas não recupera a precisão perdida.
Lições relacionadas
- Java · Lição 9 · Avançado · Versão: 2
- Java · Lição 58 · Básico · Versão: 2
- Java · Lição 59 · Básico · Versão: 2
Fontes
- Java SE 21 API — Number.doubleValue()
- Java SE 21 API — Integer.doubleValue()
- Java SE 21 API — Long.doubleValue()
- Java SE 21 API — BigDecimal.doubleValue()
- Java SE 21 API — Double.parseDouble(String)
- Java Language Specification, Java SE 21 — §5.1.2 Widening Primitive Conversion
- Java Language Specification, Java SE 21 — §5.1.3 Narrowing Primitive Conversion
- Java Language Specification, Java SE 21 — §15.12.4.4 Locate Method to Invoke