Функция minusNanos

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

Импорт

kotlinimport java.time.Instant

Синтаксис

kotlinfun minusNanos(nanosToSubtract: Long): Instant

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

kotlinval 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")

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

kotlinLong -1

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

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