Java Academy · Lección

NumberFormat y printf

Formatee números para su visualización mediante NumberFormat, DecimalFormat y patrones de printf.

NumberFormat y printf es una lección gratuita de Java Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Java Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Java Academy incluye 4 lecciones en total.

NumberFormat y printf

Java proporciona API completas para dar formato a números: NumberFormat para monedas y porcentajes según la configuración regional, DecimalFormat para patrones personalizados y printf/String.format para el formato al estilo de C.

Conceptos básicos de String.format

String.format() utiliza especificadores de formato para construir cadenas. Especificadores habituales: %d (entero), %f (coma flotante), %s (cadena), %n (salto de línea).

String name = "Alice";
int score = 95;
double avg = 87.567;

String msg = String.format(
    "Player: %s | Score: %d | Average: %.2f", name, score, avg);
System.out.println(msg);
// Player: Alice | Score: 95 | Average: 87.57

// printf is equivalent — formats directly to output
System.out.printf("%-10s %5d %8.2f%n", name, score, avg);
// Alice          95    87.57

Ancho, relleno y alineación

Los especificadores de formato admiten indicadores de ancho y alineación: %10d (alineación a la derecha en 10 caracteres), %-10d (alineación a la izquierda), %010d (relleno con ceros).

// Table layout with padding
System.out.printf("%-20s %10s %10s%n", "Product", "Qty", "Price");
System.out.printf("%-20s %10d %10.2f%n", "Java Book", 3, 49.99);
System.out.printf("%-20s %10d %10.2f%n", "USB Hub", 1, 24.95);
System.out.printf("%-20s %10d %10.2f%n", "Mechanical Keyboard", 2, 129.00);

// Zero-padding for order IDs
int orderId = 42;
System.out.printf("Order: ORD-%08d%n", orderId); // Order: ORD-00000042

NumberFormat para monedas

NumberFormat.getCurrencyInstance(Locale) da formato a los números como cadenas monetarias con el símbolo, los separadores y las posiciones decimales correctos para una configuración regional determinada.

import java.text.*;
import java.util.*;

NumberFormat usd = NumberFormat.getCurrencyInstance(Locale.US);
NumberFormat eur = NumberFormat.getCurrencyInstance(Locale.GERMANY);
NumberFormat gbp = NumberFormat.getCurrencyInstance(Locale.UK);

double amount = 1234567.89;
System.out.println(usd.format(amount)); // $1,234,567.89
System.out.println(eur.format(amount)); // 1.234.567,89 EUR
System.out.println(gbp.format(amount)); // GBP1,234,567.89

NumberFormat para porcentajes

NumberFormat.getPercentInstance() da formato a un decimal como una cadena de porcentaje. Pase un valor entre 0 y 1.

import java.text.*;
import java.util.*;

NumberFormat pct = NumberFormat.getPercentInstance(Locale.US);
pct.setMaximumFractionDigits(1);

System.out.println(pct.format(0.75));     // 75%
System.out.println(pct.format(0.1234));   // 12.3%
System.out.println(pct.format(1.0));      // 100%

// Conversion rate in e-commerce
double convRate = 3_456.0 / 42_000.0;
System.out.println("Conversion: " + pct.format(convRate)); // 8.2%

DecimalFormat con patrones personalizados

DecimalFormat utiliza una cadena de patrón en la que # representa un dígito opcional y 0 representa un dígito obligatorio.

import java.text.*;

DecimalFormat df1 = new DecimalFormat("#,###.00");
System.out.println(df1.format(1234567.5));  // 1,234,567.50

DecimalFormat df2 = new DecimalFormat("000.0");
System.out.println(df2.format(7.5));  // 007.5

DecimalFormat df3 = new DecimalFormat("0.00E0");
System.out.println(df3.format(0.000123)); // 1.23E-4

// Scientific notation for large values
DecimalFormat sci = new DecimalFormat("0.000E0");
System.out.println(sci.format(123456789)); // 1.235E8

Análisis de números a partir de cadenas

NumberFormat también puede analizar cadenas con formato regional y convertirlas de nuevo en números. Esto es esencial para leer datos introducidos por el usuario en distintas configuraciones regionales.

import java.text.*;
import java.util.*;

NumberFormat nf = NumberFormat.getInstance(Locale.GERMANY);
try {
    // German uses comma as decimal separator
    Number parsed = nf.parse("1.234,56");
    System.out.println(parsed.doubleValue()); // 1234.56

    // Parse US currency string
    NumberFormat usd = NumberFormat.getCurrencyInstance(Locale.US);
    Number amount = usd.parse("$1,234.56");
    System.out.println(amount.doubleValue()); // 1234.56
} catch (ParseException e) {
    System.out.println("Parse error: " + e.getMessage());
}

Cadenas con formato (Java 15+)

Java 15+ añade String.formatted() como alternativa basada en una instancia a String.format(), útil en cadenas de llamadas a métodos y canalizaciones de streams.

record Product(String name, double price, int stock) {}

var products = List.of(
    new Product("Laptop", 999.0, 5),
    new Product("Mouse",  29.99, 42),
    new Product("Monitor", 349.0, 8)
);

products.stream()
    .map(p -> "%-15s $%8.2f  [stock: %d]"
        .formatted(p.name(), p.price(), p.stock()))
    .forEach(System.out::println);
// Laptop          $  999.00  [stock: 5]
// Mouse           $   29.99  [stock: 42]
// Monitor         $  349.00  [stock: 8]

Agrupación de números y configuración regional

La agrupación de números (el separador de millares) varía según la configuración regional. Utilice siempre NumberFormat para los resultados que verá el usuario, en lugar de codificar comas directamente.

import java.text.*;
import java.util.*;

long users = 1_234_567;

for (Locale locale : new Locale[]{Locale.US, Locale.FRANCE, Locale.GERMANY}) {
    NumberFormat nf = NumberFormat.getIntegerInstance(locale);
    System.out.printf("%-10s: %s%n", locale, nf.format(users));
}
// en_US     : 1,234,567
// fr_FR     : 1 234 567
// de_DE     : 1.234.567

Ejemplo de generación de facturas

Cómo unirlo todo: generar una factura con formato, con la moneda y el porcentaje correctos y una alineación adecuada de la tabla.

import java.text.*;
import java.util.*;

NumberFormat curr = NumberFormat.getCurrencyInstance(Locale.US);
NumberFormat pct  = NumberFormat.getPercentInstance();
pct.setMaximumFractionDigits(0);

double subtotal = 1259.97;
double discount = 0.10;
double discountAmt = subtotal * discount;
double taxRate = 0.08;
double taxAmt = (subtotal - discountAmt) * taxRate;
double total = subtotal - discountAmt + taxAmt;

System.out.println("=== INVOICE ===");
System.out.printf("%-20s %15s%n", "Subtotal",       curr.format(subtotal));
System.out.printf("%-20s %15s%n", "Discount (" + pct.format(discount) + ")",
    "-" + curr.format(discountAmt));
System.out.printf("%-20s %15s%n", "Tax (" + pct.format(taxRate) + ")",
    curr.format(taxAmt));
System.out.printf("%-20s %15s%n", "TOTAL", curr.format(total));

Errores frecuentes

Tenga cuidado con estos errores habituales al dar formato:

Utilizar String.format con un especificador de tipo incorrecto (por ejemplo, %d para un double) lanza IllegalFormatConversionException
Los formateadores específicos de una configuración regional producen resultados diferentes en distintas máquinas
Las instancias de NumberFormat no son seguras para subprocesos; cree una por subproceso o utilice ThreadLocal

// Wrong specifier
try {
    String.format("%d", 3.14); // IllegalFormatConversionException
} catch (java.util.IllegalFormatConversionException e) {
    System.out.println("Wrong format specifier!");
}

// Thread-safe pattern using ThreadLocal
ThreadLocal<NumberFormat> localFmt = ThreadLocal
    .withInitial(() -> NumberFormat.getCurrencyInstance(Locale.US));
// each thread gets its own NumberFormat instance

Comprobación rápida

¿Qué resultado produce String.format("%08.2f", 3.5)?

Repaso: NumberFormat y printf

Conceptos clave:

String.format / printf utilizan especificadores de formato: %d, %f, %s, %.2f
Indicadores de ancho y alineación: %10d (derecha), %-10d (izquierda), %010d (relleno con ceros)
NumberFormat.getCurrencyInstance() para mostrar monedas según la configuración regional
NumberFormat.getPercentInstance() para mostrar porcentajes
DecimalFormat utiliza patrones de dígitos # (opcional) y 0 (obligatorio)
NumberFormat también puede analizar cadenas con formato regional y convertirlas de nuevo en números

Preguntas frecuentes

¿La lección «NumberFormat y printf» es gratis?

Sí — el texto completo de «NumberFormat y printf» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Java Academy, actualiza a CoddyKit PRO. El curso de Java Academy incluye 4 lecciones en total.

¿Qué aprenderé en «NumberFormat y printf»?

Formatee números para su visualización mediante NumberFormat, DecimalFormat y patrones de printf. Practicas Java Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Java Academy?

No se requiere experiencia previa. Java Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.

¿Cuánto tiempo toma la lección «NumberFormat y printf»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Java Academy?

Sí. Cada lección de Java Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a Java Academy