Метод negated

Метод negated класса Duration возвращает новую длительность с противоположным значением. Если исходная длительность положительная, то возвращается отрицательная, и наоборот.

Импорт

import kotlin.time.Duration
import kotlin.time.Duration.Companion.hours
import kotlin.time.Duration.Companion.minutes

Синтаксис

fun negated(): Duration

Пример

Создадим положительную длительность и получим ее отрицательное значение:

val duration = 5.hours
val negatedDuration = duration.negated()
println("Original: $duration")
println("Negated: $negatedDuration")

Результат выполнения кода:

String "Original: 5h"
String "Negated: -5h"

Пример

Создадим отрицательную длительность и получим ее положительное значение:

val duration = (-30).minutes
val negatedDuration = duration.negated()
println("Original: $duration")
println("Negated: $negatedDuration")

Результат выполнения кода:

String "Original: -30m"
String "Negated: 30m"

Пример

Проверим, что двойное применение negated возвращает исходное значение:

val original = 2.hours
val onceNegated = original.negated()
val twiceNegated = onceNegated.negated()

println("Original: $original")
println("Once negated: $onceNegated")
println("Twice negated: $twiceNegated")
println("Are equal: ${original == twiceNegated}")

Результат выполнения кода:

String "Original: 2h"
String "Once negated: -2h"
String "Twice negated: 2h"
String "Are equal: true"

Смотрите также

метод abs класса Duration,
который возвращает абсолютное значение длительности
метод isNegative класса Duration,
который проверяет, является ли длительность отрицательной
метод negated класса Period,
который возвращает противоположный период
метод plus класса Duration,
который складывает длительности