parseOrNull

kotlin-stdlib / kotlin.time / Duration / parseOrNull

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

fun parseOrNull(value: String): Duration?

Парсит строку, представляющую продолжительность, и возвращает значение Duration, полученное после парсинга, или null если строка не представляет собой продолжительность ни в одном из поддерживаемых форматов.

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

Ограниченное представление составной продолжительности ISO-8601, например 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
}

© 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-or-null.html