String.format: примеры (JAVA)

second first first

Пример 8: литерал процента и перевод строки

String f = String.format("Progress: %d%% %n", 75);
System.out.print(f);

Progress: 75% 

В Java доступны другие средства форматирования строк, отличающиеся по назначению:

• java.util.Formatter - базовый класс, обеспечивающий те же спецификации, но с возможностью вывода в Appendable; удобен при форматировании в поток или StringBuilder.
• System.out.printf / System.out.format - обёртки, формирующие и сразу выводящие отформатированные данные на консоль; полезны для логирования и интерактивных приложений.
• java.text.MessageFormat - ориентирован на интернационализацию; лучше для составления сообщений с учетом правил языка, множества форматов и порядка аргументов при локализации.
• NumberFormat, DateFormat, DateTimeFormatter - специализированные парсеры и форматтеры для чисел и дат с поддержкой локали; предпочтительнее при сложных локализационных правилах.

Выбор зависит от задачи: для простых форматных строк удобен String.format, при международных сообщениях и изменяемом порядке аргументов предпочтительнее MessageFormat, для вывода в поток подходит Formatter.

Краткий обзор аналогичных функций в популярных языках с примерами.

PHP - sprintf

$s = sprintf("Hello, %s! %d%%", "Bob", 80);
echo $s;

Hello, Bob! 80%

JavaScript - шаблонные строки и util.format (Node.js)

// Шаблонные строки
let name = 'Eve';
let s = `Hello, ${name}!`;
console.log(s);

// Node.js util.format
const util = require('util');
console.log(util.format('Number: %d, Hex: %x', 42, 42));

Hello, Eve!
Number: 42, Hex: 2a

Python - форматирование через format и f-строки

s = "Hello, {}! {:.2f}".format('Ann', 1.23456)
print(s)

# f-строка
name = 'Ann'
value = 1.23456
print(f"Hello, {name}! {value:.2f}")

Hello, Ann! 1.23
Hello, Ann! 1.23

SQL - функции форматирования зависят от СУБД

-- PostgreSQL
SELECT to_char(now(), 'YYYY-MM-DD HH24:MI:SS');

-- MySQL
SELECT FORMAT(1234567.89, 2);

2026-04-24 12:34:56
1,234,567.89

C# - string.Format и интерполяция

string s = string.Format("{0}, {1:000}", "Id", 5);
Console.WriteLine(s);

// Интерполяция
int x = 5;
Console.WriteLine($"Value: {x:D3}");

Id, 005
Value: 005

Lua - string.format

local s = string.format("%s: %.2f", "pi", 3.14159)
print(s)

pi: 3.14

Go - fmt.Sprintf

s := fmt.Sprintf("%s %d", "count", 10)
fmt.Println(s)

count 10

Kotlin - String.format и шаблоны строк

val s = String.format("Hello, %s!", "Kotlin")
println(s)

// Шаблонная строка
val name = "Kotlin"
println("Hello, $name!")

Hello, Kotlin!
Hello, Kotlin!

Отличия от Java: синтаксис спецификаторов у языков часто схож с C-подобным, но локализация, поддерживаемые флаги и поведение с null/None/undefined различаются. В языках с интерполяцией (JS, Kotlin, C#) привычные случаи форматирования строк решаются проще с меньшим количеством спецификаторов, тогда как sprintf-подобные функции дают точный контроль над форматом.

Ниже перечислены распространённые ошибки при использовании String.format с примерами кода и результатами в виде исключений или неожиданных значений.

Ошибка 1: несовпадение спецификатора и типа аргумента

String s = String.format("%d", "not a number");

Exception in thread "main" java.util.IllegalFormatConversionException: d != java.lang.String

Ошибка 2: недостаточно аргументов

String s = String.format("%s %s", "one");

Exception in thread "main" java.util.MissingFormatArgumentException: Format specifier '%s'

Ошибка 3: null вместо строки-шаблона

String s = String.format(null, "a");

Exception in thread "main" java.lang.NullPointerException

Ошибка 4: неверная ширина или флаг

String s = String.format("%0-5d", 1);

Exception in thread "main" java.util.IllegalFormatFlagsException: 0

Ошибка 5: применение числовых флагов к null

String s = String.format("%d", (Integer) null);
System.out.println(s);

Exception in thread "main" java.lang.NullPointerException

Замечание: стек трассировки в разных JVM частично отличается, но тип исключения и причина форматирования остаются предсказуемыми. Рекомендуется проверять соответствие типов и количество аргументов и учитывать возможные null-значения перед вызовом String.format.

Метод String.format введён вместе с классом Formatter в JDK 5. С тех пор его поведение остаётся стабильным. Небольшие изменения могли коснуться поддержки локалей и обновления форматов даты/времени вслед за обновлениями стандартных библиотек и спецификаций Unicode. В практическом применении API не подвергался значительным изменениям в более поздних релизах Java. Для специфичных требований к локализации обычно используются NumberFormat и DateTimeFormatter, которые эволюционировали независимо от String.format.

Несколько углублённых образцов применения с пояснениями.

1) Реализация собственного форматирования через интерфейс Formattable

public class Point implements java.util.Formattable {
    private final int x, y;
    public Point(int x, int y) { this.x = x; this.y = y; }
    @Override
    public void formatTo(java.util.Formatter formatter, int flags, int width, int precision) {
        String out = String.format("(%d,%d)", x, y);
        if (precision >= 0 && precision < out.length()) {
            out = out.substring(0, precision);
        }
        if ((flags & java.util.FormattableFlags.LEFT_JUSTIFY) != 0) {
            formatter.format("%-" + width + "s", out);
        } else {
            formatter.format("%" + width + "s", out);
        }
    }
}

Point p = new Point(10, 20);
String s = String.format("Point: %10s", p);
System.out.println(s);

Point:     (10,20)

Комментарий: интерфейс позволяет задать собственную логику форматирования объектов при использовании %s.

2) Множественные спецификаторы даты, использование Instant и ZoneId

Instant now = Instant.parse("2026-04-24T08:30:00Z");
ZonedDateTime z = ZonedDateTime.ofInstant(now, ZoneId.of("Europe/Moscow"));
String s = String.format(Locale.US, "%1$tF %1$tT %1$tZ", z);
System.out.println(s);

2026-04-24 11:30:00 MSK

Комментарий: %t-спецификаторы принимают TemporalAccessor через обёртку; порядок и локаль влияют на отображение.

3) Форматирование BigDecimal с точной настройкой и группировкой

BigDecimal big = new BigDecimal("1234567.89123");
String s = String.format(Locale.US, "%,.3f", big);
System.out.println(s);

1,234,567.891

Комментарий: использование BigDecimal обеспечивает контроль точности вычислений, а формат задаёт вывод с группировкой.

4) Комбинация позиционных аргументов для локализованных сообщений

// Допустим нужно поменять порядок аргументов для других языков
String base = "{0} bought {1} items for {2}"; // MessageFormat удобнее
String s = String.format("%2$s: %1$d pcs, total %3$.2f", "Widget", 5, 123.456);
System.out.println(s);

// Повтор в разных местах
String s2 = String.format("%1$s %1$s %

Widget: 5 pcs, total 123.46
repeat repeat repeat

int flags = 0b1011;
String s = String.format("dec=%d oct=%o hex=%#x", flags, flags, flags);
System.out.println(s);

dec=11 oct=13 hex=0xb

try (Writer w = new FileWriter("out.txt");
     Formatter fm = new Formatter(w, Locale.US)) {
    fm.format("Name: %s, Score: %.1f%n", "Player", 99.5);
}
// Файл out.txt содержит одну строку

(файл) Name: Player, Score: 99.5

String s = String.format("Value: %s", (Object) null);
System.out.println(s);

Value: null