Форматирование строк в Kotlin: как использовать String.format и шаблоны?

Основные подходы к форматированию строк в Kotlin

В Kotlin есть два основных способа форматирования строк: шаблоны строк (string templates) и функция String.format(). Оба работают, но для разных сценариев. Давайте разберём их на примерах.

1. Шаблоны строк (рекомендуемый способ для простых случаев)

Шаблоны с $ — это встроенная возможность Kotlin, которая транслируется в конкатенацию строк на байткоде. Они идеальны для подстановки переменных и вызова методов:

val name = "Кофе"
val price = 123.4567
// Простая подстановка
println("Товар: $name, Цена: $price") 
// Вызов метода внутри шаблона
println("Цена с округлением: ${"%.2f".format(price)} руб.")

Обратите внимание: "%.2f".format(price) — это не статический метод Java, а функция-расширение для String, добавленная в Kotlin. Она использует тот же java.util.Formatter под капотом, но синтаксис более идиоматичный. Для округления до двух знаков это работает отлично.

2. Классический String.format() (для сложного форматирования)

Если вам нужно выравнивание, заполнители, работа с датами или локалью, используйте String.format() — он доступен без deprecated и является частью стандартной библиотеки Kotlin (на самом деле это Java-метод, но Kotlin предоставляет для него синтаксический сахар):

val price = 123.4567
val name = "Кофе"
val result = String.format("Товар: %-10s, Цена: %08.2f руб.", name, price)
println(result) // Выведет: "Товар: Кофе      , Цена: 00123.46 руб."

Здесь:

• %-10s — строка, выровненная влево, шириной 10 символов;
• %08.2f — число с двумя знаками после запятой, дополненное нулями до 8 символов.

Если вы работаете с датами, можно использовать String.format("%tF", date) или DateTimeFormatter из Java 8+. Kotlin не добавляет своих обёрток для дат, поэтому используйте стандартный Java API:

import java.time.LocalDate
import java.time.format.DateTimeFormatter

val date = LocalDate.now()
val formatted = date.format(DateTimeFormatter.ofPattern("dd.MM.yyyy"))
println("Сегодня: $formatted")

3. Использование kotlin.text.format (альтернатива)

В Kotlin есть функция-расширение format() для строк, которая принимает массив аргументов. Это более краткий аналог String.format():

val template = "Товар: %s, Цена: %.2f руб."
println(template.format(name, price))

Этот способ предпочтительнее, так как он читается естественнее и не требует статического импорта.

4. Форматирование чисел с помощью DecimalFormat

Для сложного форматирования чисел (например, разделители тысяч, валюта) используйте java.text.DecimalFormat:

val df = java.text.DecimalFormat("#,###.00")
println(df.format(1234567.89)) // "1,234,567.89"

Итог

• Для простой подстановки переменных — используйте $variable.
• Для форматирования с округлением/заполнением — "%10.2f".format(value).
• Для сложных шаблонов (даты, локали) — String.format() или DecimalFormat.
• Избегайте старого Java-стиля System.out.printf() — он работает, но не идиоматичен для Kotlin.

Ваш пример с ценой решается одной строкой:

println("Товар: $name, Цена: ${"%.2f".format(price)} руб.")

Это и кратко, и понятно.

val name = "Кофе"
val price = 123.4567
val report = """
    Отчёт о товаре:
    -----------------
    Наименование: $name
    Цена: ${"%.2f".format(price)} руб.
    Дата: ${java.time.LocalDate.now()}
""".trimIndent()
println(report)

val items = listOf("Кофе" to 120.0, "Чай" to 80.5)
val receipt = buildString {
    appendLine("Чек:")
    items.forEach { (name, price) ->
        appendLine("$name: ${"%.2f".format(price)} руб.")
    }
    appendLine("Итого: ${"%.2f".format(items.sumOf { it.second })} руб.")
}
println(receipt)