Функция plusNanos

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

Импорт

import java.time.LocalDateTime

Синтаксис

fun plusNanos(nanos: Long): LocalDateTime

Пример

Добавим 500000000 наносекунд (0.5 секунды) к дате и времени "2025-06-15T10:30:00":

val dateTime = LocalDateTime.parse("2025-06-15T10:30:00")
val result = dateTime.plusNanos(500000000)
println(result)

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

String "2025-06-15T10:30:00.500"

Пример

Добавим 1000000000 наносекунд (1 секунду) и проверим изменение времени:

val dateTime = LocalDateTime.of(2025, 12, 31, 23, 59, 59)
val newDateTime = dateTime.plusNanos(1000000000)

val originalSecond = dateTime.second
val newSecond = newDateTime.second

println("Original second: $originalSecond")
println("New second: $newSecond")

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

String "Original second: 59"
String "New second: 0"

Пример

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

val dateTime = LocalDateTime.parse("2025-03-20T15:45:30.500")
val result = dateTime.plusNanos(-200000000)
println(result)

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

String "2025-03-20T15:45:30.300"

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

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