parse

kotlin-stdlib / kotlin.time / Duration / parse

Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

fun parse(value: String): Duration

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

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

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

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"
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
}

Исключения

IllegalArgumentException — если строка не представляет продолжительность в поддерживаемом формате.

© 2010–2022 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.html