CKTIS / Java
Number.doubleValue() — convertir a double
El método devuelve el valor de un objeto `Number` como un `double` primitivo. La exactitud depende del subtipo real del objeto y de si el valor se puede representar exactamente como `double`.
Versión: Java SE 21
Sintaxis
public abstract double doubleValue();
// n is a non-null Number reference:
double value = n.doubleValue();Number.doubleValue() es un método de instancia abstracto y sin argumentos, declarado en java.lang.Number. La llamada n.doubleValue() devuelve un valor primitivo de tipo double, no un objeto Double. Aunque n esté declarado como Number, Java utiliza la implementación de la clase real del objeto.
Todos los valores Integer se convierten de forma exacta, pero algunos valores Long deben redondearse. La conversión de un BigDecimal puede perder precisión incluso si el resultado es finito, y puede devolver un infinito con el signo correspondiente si el valor absoluto es demasiado grande. Si el cálculo debe ser exacto, no uses double cuando no pueda representar el valor con exactitud.
Si n es null, la llamada lanza NullPointerException. Este método convierte el valor de un objeto numérico existente; no interpreta texto. Para leer un número de un String, usa Double.parseDouble(String).
Ejemplos
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
Las dos primeras líneas muestran el valor exacto `42.0` antes de multiplicar por `2` y el resultado `84.0`. Las dos últimas comparan el `long` original con el resultado de convertirlo a `double` y de nuevo a `long`. La conversión explícita `(long)` permite imprimir aquí el valor redondeado como entero, pero no recupera la precisión perdida.
Lecciones relacionadas
- Java · Lección 9 · Avanzado · Versión: 2
- Java · Lección 58 · Básico · Versión: 2
- Java · Lección 59 · Básico · Versión: 2
Fuentes
- 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