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]conversionString.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.