Formato de cadenas en Java: String.format, printf y especificadores de formato

Dos formas de dar formato

Java da formato a las cadenas a partir de una plantilla que contiene especificadores de formato (los marcadores %) más los valores que se insertan. Hay dos puntos de entrada y comparten una sintaxis idéntica:

• String.format(template, values...) devuelve un nuevo String.
• System.out.printf(template, values...) imprime el resultado directamente.

public class Main {
    public static void main(String[] args) {
        String name = "Ada";
        int age = 36;

        String line = String.format("%s is %d years old", name, age);
        System.out.println(line);

        System.out.printf("%s is %d years old%n", name, age);
    }
}

Ambas producen el mismo texto. String.format te lo devuelve para que puedas almacenarlo; printf lo escribe en la consola. Observa el %n al final de la plantilla de printf: es el salto de línea independiente de la plataforma (prefiérelo sobre \n en las cadenas de formato).

Los especificadores más comunes

Cada especificador empieza con % y termina con una letra que indica qué tipo de valor se espera:

public class Main {
    public static void main(String[] args) {
        System.out.printf("string: %s%n", "hello");
        System.out.printf("integer: %d%n", 42);
        System.out.printf("float: %f%n", 3.14);
        System.out.printf("boolean: %b%n", true);
        System.out.printf("char: %c%n", 'A');
        System.out.printf("hex: %x%n", 255);
        System.out.printf("percent sign: %%%n");
    }
}

Los tres de uso diario son %s (cualquier valor, mediante su toString), %d (números enteros) y %f (decimales). Usa %% para imprimir un signo de porcentaje literal. Pasar el tipo equivocado —por ejemplo, un String a %d— lanza una IllegalFormatConversionException en tiempo de ejecución.

Controlar las posiciones decimales

%f usa por defecto seis decimales, que rara vez es lo que quieres. Pon .N antes de la f para fijar la precisión (el valor se redondea):

public class Main {
    public static void main(String[] args) {
        double price = 3.14159;

        System.out.printf("%f%n", price);     // 3.141590
        System.out.printf("%.2f%n", price);   // 3.14
        System.out.printf("%.0f%n", price);   // 3
    }
}

Añade el indicador de coma para los separadores de agrupación en números grandes:

public class Main {
    public static void main(String[] args) {
        double total = 1234567.891;
        System.out.printf("%,.2f%n", total);   // 1,234,567.89
    }
}

Ancho y relleno

Un número entre el % y la letra del tipo establece un ancho mínimo de campo, rellenando con espacios para que las columnas se alineen. Un - inicial alinea a la izquierda; un 0 inicial rellena los números con ceros:

public class Main {
    public static void main(String[] args) {
        System.out.printf("[%10s]%n", "hi");    // right-aligned in 10 cols
        System.out.printf("[%-10s]%n", "hi");   // left-aligned
        System.out.printf("[%05d]%n", 42);      // zero-padded to width 5
    }
}

Esto es lo que hace legibles las tablas formateadas y los informes alineados:

public class Main {
    public static void main(String[] args) {
        String[] names = {"Ada", "Boris", "Chen"};
        int[] scores = {95, 8, 142};

        for (int i = 0; i < names.length; i++) {
            System.out.printf("%-8s %5d%n", names[i], scores[i]);
        }
    }
}

El %-8s alinea los nombres a la izquierda en una columna de 8 de ancho y %5d alinea las puntuaciones a la derecha en una columna de 5 de ancho, de modo que los números quedan alineados sin importar la cantidad de dígitos.

Orden de los argumentos

De forma predeterminada, los especificadores consumen los valores de izquierda a derecha. Puedes repetir o reordenar un valor con N$ (índice basado en uno), útil cuando el mismo valor aparece dos veces:

public class Main {
    public static void main(String[] args) {
        System.out.printf("%1$s, %1$s, hello %2$s%n", "echo", "world");
    }
}

%1$s se refiere al primer argumento las dos veces, por lo que echo se imprime dos veces.

El método formatted()

Desde Java 15, toda cadena tiene un método de instancia formatted: el mismo motor que String.format, solo que escrito como una llamada de método sobre la plantilla:

public class Main {
    public static void main(String[] args) {
        String msg = "%s scored %d".formatted("Ada", 95);
        System.out.println(msg);
    }
}

Combina especialmente bien con los text blocks (cadenas multilínea entre comillas triples) al construir salidas formateadas más grandes.

Cuándo no usar String.format

Para uniones sencillas y puntuales, la concatenación simple con + es más clara y rápida:

String greeting = "Hi, " + name + "!";   // simpler than String.format here

Recurre a String.format / printf cuando necesites formato de verdad —decimales fijos, relleno, alineación, agrupación— y no solo pegar un par de valores.

Siguiente: Operadores

Dar formato convierte valores en texto. Para calcular esos valores en primer lugar necesitas los operadores de Java: aritméticos, de comparación y lógicos. Esa es la siguiente página.