Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

String.format — dar formato al texto

String.format crea texto a partir de una cadena de formato y argumentos mediante especificadores como %s, %d y %.2f. Un Locale explícito permite que el formato numérico no dependa de la configuración regional predeterminada del entorno.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

String.format(String format, Object... args)
String.format(Locale l, String format, Object... args)
%[argument_index$][flags][width][.precision]conversion

String.format es un método estático que devuelve un String con formato; no imprime el resultado por sí mismo. La cadena de formato combina texto normal con especificadores definidos por Formatter. Los argumentos se pasan después de la cadena de formato como Object... args.

La sobrecarga String.format(String format, Object... args) utiliza Locale.getDefault(Locale.Category.FORMAT). La variante String.format(Locale l, String format, Object... args) permite indicar el Locale explícitamente; null significa que no se aplica localización. El ejemplo usa Locale.US para que el separador decimal sea un punto.

Para las conversiones habituales, la sintaxis es %[argument_index$][flags][width][.precision]conversion. %s da formato a la representación en texto de un argumento, %d a un entero decimal y %.2f a un número de coma flotante con dos cifras después del separador decimal. %04d establece una anchura mínima de cuatro caracteres y rellena con ceros. %2$s selecciona el segundo argumento. %% inserta un % literal sin consumir un argumento; %n inserta el separador de línea propio de la plataforma.

Una cadena de formato no válida, un tipo incompatible o la falta de un argumento necesario provoca IllegalFormatException. Por ejemplo, %d no acepta un String que contenga dígitos. Los argumentos sobrantes se ignoran; el tratamiento de los valores null depende de la conversión. Mantén el control de la cadena de formato y pasa los datos variables como argumentos.

Ejemplos

import java.util.Locale;

public class Main {
    public static void main(String[] args) {
        String result = String.format(
            Locale.US, "%s | id=%04d | score=%.2f | %d%%",
            "Ada", 7, 12.5, 80
        );
        System.out.print(result);
    }
}

Resultado

Ada | id=0007 | score=12.50 | 80%

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes