Функция minusNanos

Функция minusNanos класса Instant вычитает указанное количество наносекунд из момента времени. В параметр мы передаем количество наносекунд для вычитания. Функция возвращает новый объект Instant с измененным временем.

Импорт

import java.time.Instant

Синтаксис

fun minusNanos(nanosToSubtract: Long): Instant

Пример

Вычтем 500000000 наносекунд (0.5 секунды) из текущего момента времени:

val instant = Instant.now()
val result = instant.minusNanos(500000000)
println("Original: $instant")
println("After subtraction: $result")

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

String "Original: 2025-09-10T12:30:45.123456789Z"
String "After subtraction: 2025-09-10T12:30:44.623456789Z"

Пример

Вычтем 1000000000 наносекунд (1 секунду) из конкретного момента времени:

val instant = Instant.parse("2025-07-15T10:30:00.123456789Z")
val result = instant.minusNanos(1000000000)
println(result)

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

String "2025-07-15T10:29:59.123456789Z"

Пример

Вычтем несколько наносекунд и проверим разницу:

val instant1 = Instant.parse("2025-12-31T23:59:59.999999999Z")
val instant2 = instant1.minusNanos(1)

val diff = instant1.until(instant2, java.time.temporal.ChronoUnit.NANOS)
println("Difference in nanoseconds: $diff")

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

Long -1

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

функцию plusNanos класса Instant,
которая добавляет наносекунды к моменту времени
функцию minusSeconds класса Instant,
которая вычитает секунды из момента времени
функцию getNano класса Instant,
которая возвращает наносекундную компоненту момента времени
класс Duration,
который представляет продолжительность времени