parse

kotlin-stdlib/kotlin.time/Duration/Companion/parse

Начиная с Kotlin: 1.6

fun parse(value: String): Duration

Разбирает строку, представляющую длительность, и возвращает разобранное значение Duration.

Поддерживаются следующие форматы:

Формат длительности ISO-8601, например P1DT2H3M4.058S; см. toIsoString и parseIsoString.
Формат строки, возвращаемой по умолчанию методом Duration.toString, и toString в заданной единице измерения, например 10s, 1h 30m или -(1h 30m).

Вызывает исключение

IllegalArgumentException

если строка не представляет длительность ни в одном из поддерживаемых форматов.

Примеры

import kotlin.test.*
import kotlin.time.*
import kotlin.time.Duration.Companion.days
import kotlin.time.Duration.Companion.hours
import kotlin.time.Duration.Companion.microseconds
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() { 
   //sampleStart 
   val isoFormatString = "PT1H30M"
val defaultFormatString = "1h 30m"
val singleUnitFormatString = "1.5h"
val invalidFormatString = "1 hour 30 minutes"

println(Duration.parse(isoFormatString)) // 1h 30m
println(Duration.parse(defaultFormatString)) // 1h 30m
println(Duration.parse(singleUnitFormatString)) // 1h 30m
// Duration.parse(invalidFormatString) // will fail
println(Duration.parseOrNull(invalidFormatString)) // null 
   //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.time/-duration/-companion/parse.html