Функция plusNanos

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

Импорт

import java.time.Instant

Синтаксис

fun plusNanos(nanosToAdd: Long): Instant

Пример

Добавим 500 наносекунд к текущему моменту времени:

val instant = Instant.now()
val result = instant.plusNanos(500)
println("Original: $instant")
println("After adding 500 nanoseconds: $result")

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

String "Original: 2025-09-10T14:30:15.123456789Z"
String "After adding 500 nanoseconds: 2025-09-10T14:30:15.123457289Z"

Пример

Добавим 1 000 000 наносекунд (1 миллисекунду) к конкретному моменту времени:

val instant = Instant.parse("2025-01-01T00:00:00.000000000Z")
val result = instant.plusNanos(1_000_000)
println(result)

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

String "2025-01-01T00:00:00.001000000Z"

Пример

Добавим отрицательное количество наносекунд (вычитание):

val instant = Instant.parse("2025-12-31T23:59:59.999999999Z")
val result = instant.plusNanos(-500)
println(result)

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

String "2025-12-31T23:59:59.999999499Z"

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

функцию plusSeconds класса Instant,
которая добавляет секунды к моменту времени
функцию plusMillis класса Instant,
которая добавляет миллисекунды к моменту времени
функцию minusNanos класса Instant,
которая вычитает наносекунды из момента времени
функцию getNano класса Instant,
которая возвращает наносекундную компоненту момента времени