format

Начиная с Kotlin: 1.0

inline fun String.format(vararg args: Any?): String

Использует эту строку в качестве строки формата и возвращает строку, полученную заменой спецификаторов формата в строке формата предоставленными аргументами с использованием локали по умолчанию.

Синтаксис спецификаторов формата для строки формата описан в документации класса java.util.Formatter.

Примеры

import kotlin.test.*
import java.util.*
import java.util.regex.*

fun main() { 
   //sampleStart 
   // format negative number in parentheses
val negativeNumberInParentheses = "%(d means %1\$d".format(-31416)
println(negativeNumberInParentheses) // (31416) means -31416 
   //sampleEnd
}

inline fun String.Companion.format(format: String, vararg args: Any?): String

Использует предоставленный формат в качестве строки формата и возвращает строку, полученную заменой спецификаторов формата в строке формата предоставленными аргументами с использованием локали по умолчанию.

Синтаксис спецификаторов формата для строки формата описан в документации класса java.util.Formatter.

Примеры

import kotlin.test.*
import java.util.*
import java.util.regex.*

fun main() { 
   //sampleStart 
   // format negative number in parentheses
val negativeNumberInParentheses = String.format("%(d means %1\$d", -31416)
println(negativeNumberInParentheses) // (31416) means -31416 
   //sampleEnd
}

inline fun String.format(locale: Locale?, vararg args: Any?): String

Синтаксис спецификаторов формата для строки формата описан в документации класса java.util.Formatter.

Примеры

import kotlin.test.*
import java.util.*
import java.util.regex.*

fun main() { 
   //sampleStart 
   // format with German conventions
val withGermanThousandsSeparator = "%,d".format(Locale.GERMANY, 12345)
println(withGermanThousandsSeparator) // 12.345
// 12.345

// format with US conventions
val withUSThousandsSeparator = "%,d".format(Locale.US, 12345)
println(withUSThousandsSeparator) // 12,345 
   //sampleEnd
}

inline fun String.Companion.format(locale: Locale?, format: String, vararg args: Any?): String

Синтаксис спецификаторов формата для строки формата описан в документации класса java.util.Formatter.

Примеры

import kotlin.test.*
import java.util.*
import java.util.regex.*

fun main() { 
   //sampleStart 
   // format with German conventions
val withGermanThousandsSeparator = String.format(Locale.GERMANY, "%,d", 12345)
println(withGermanThousandsSeparator) // 12.345

// format with US conventions
val withUSThousandsSeparator = String.format(Locale.US, "%,d", 12345)
println(withUSThousandsSeparator) // 12,345 
   //sampleEnd
}

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.text/format.html