parseIsoString
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
fun parseIsoString(value: String): Duration
Парсит строку, представляющую продолжительность в ограниченном составном представлении ISO-8601, и возвращает значение Duration, полученное в результате парсинга. Составное представление — это упрощенная версия формата продолжительности ISO-8601, которая поддерживает отрицательные продолжительности и отрицательные значения отдельных компонентов.
Наложены следующие ограничения:
- Единственный разрешенный не временной элемент — дни (
D).Y(годы),W(недели) иM(месяцы) не поддерживаются. - День считается равным ровно 24 часам (шкала времени 24-часовых часов).
- Альтернативное представление на основе недель
["P"][number]["W"]не поддерживается.
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
val isoFormatString = "PT1H30M"
val defaultFormatString = "1h 30m"
println(Duration.parseIsoString(isoFormatString)) // 1h 30m
// Duration.parseIsoString(defaultFormatString) // will fail
println(Duration.parseIsoStringOrNull(defaultFormatString)) // null
//sampleEnd
}Исключения
IllegalArgumentException — если строка не представляет продолжительность в формате ISO-8601.
© 2010–2023 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.time/-duration/parse-iso-string.html