Spec-Zone.ru › Kotlin 1.8

parseIsoString

kotlin-stdlib / kotlin.time / Duration / 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API