toString

fun toString(): String

Возвращает строковое представление значения этой продолжительности, выраженное в единицах, которые дают наиболее компактное и удобочитаемое числовое значение.

Особые случаи:

• продолжительность нуля форматируется как "0s"
• бесконечная продолжительность форматируется как "Infinity" без единиц
• очень малые продолжительности (менее 1e-15 с) выражаются в секундах и форматируются в научной записи
• очень большие продолжительности (более 1e+7 дней) выражаются в днях и форматируются в научной записи

import kotlin.time.*

fun main(args: Array<String>) {
//sampleStart
println(45.days) // 45.0d
println(1.5.days) // 36.0h
println(1230.minutes) // 20.5h
println(920.minutes) // 920m
println(1.546.seconds) // 1.55s
println(25.12.milliseconds) // 25.1ms
//sampleEnd
}

Возвращает значение продолжительности в автоматически определённой единице, после которой следует сокращённое наименование этой единицы: d, h, m, s, ms, us, или ns.

fun toString(unit: DurationUnit, decimals: Int = 0): String

Возвращает строковое представление значения этой продолжительности, выраженное в заданной единице и отформатированное с указанным количеством десятичных знаков после точки.

Особые случаи:

• бесконечная продолжительность форматируется как "Infinity" без единиц

import kotlin.time.*

fun main(args: Array<String>) {
//sampleStart
println(1230.minutes.toString(DurationUnit.DAYS, 2)) // 0.85d
println(1230.minutes.toString(DurationUnit.HOURS, 2)) // 20.50h
println(1230.minutes.toString(DurationUnit.MINUTES)) // 1230m
println(1230.minutes.toString(DurationUnit.SECONDS)) // 73800s
//sampleEnd
}

Исключения

IllegalArgumentException - если decimals меньше нуля.

Возвращает значение продолжительности в заданной единице , за которой следует сокращённое наименование этой единицы: d, h, m, s, ms, us, или ns.