toString

fun toString(): String

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

Каждый компонент — это число, за которым следует сокращённое наименование единицы: d, h, m, s: 5h, 1d 12h, 1h 0m 30.340s. Последний компонент, обычно секунды, может быть числом с дробной частью.

Если продолжительность меньше секунды, она представляется как одно число с одной из долей секунды: ms (миллисекунды), us (микросекунды) или ns (наносекунды): 140.884ms, 500us, 24ns.

Для отрицательной продолжительности добавляется знак -, а если она состоит из нескольких компонентов, она окружена скобками: -12m и -(1h 30m).

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

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

Рекомендуется использовать toIsoString, который использует более строгий формат ISO-8601 вместо этого toString при преобразовании продолжительности в строку в случаях сериализации, обмена данными и т. д.

import kotlin.test.*

import kotlin.time.*
import kotlin.time.Duration.Companion.days
import kotlin.time.Duration.Companion.milliseconds
import kotlin.time.Duration.Companion.minutes
import kotlin.time.Duration.Companion.nanoseconds
import kotlin.time.Duration.Companion.seconds

fun main(args: Array<String>) {
//sampleStart
println(45.days) // 45d
println(1.5.days) // 1d 12h
println(1230.minutes) // 20h 30m
println(920.minutes) // 15h 20m
println(1.546.seconds) // 1.546s
println(25.12.milliseconds) // 25.12ms
//sampleEnd
}

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

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

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

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

import kotlin.test.*

import kotlin.time.*
import kotlin.time.Duration.Companion.days
import kotlin.time.Duration.Companion.milliseconds
import kotlin.time.Duration.Companion.minutes
import kotlin.time.Duration.Companion.nanoseconds
import kotlin.time.Duration.Companion.seconds

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
}

Параметры

decimals — количество десятичных знаков после запятой для отображения. Значение должно быть неотрицательным. Не более 12 десятичных знаков будут показаны, даже если запрошено большее количество.

Исключения

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

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