LocalTime plusNanos() method in Java with Examples

The plusNanos() method of LocalTime class used to add specified no of nanoseconds value to this LocalTime and return the result as a LocalTime object. This instant is immutable. The calculation wraps around midnight.

Syntax:

public LocalTime plusNanos(long nanosecondsToAdd)

Parameters: This method accepts a single parameter nanosecondsToAdd which is the value of nanoseconds to be added, it can be a negative value.

Return value: This method returns a LocalTime based on this time with the nanoseconds added.

Below programs illustrate the plusNanos() method:

Program 1:

// Java program to demonstrate
// LocalTime.plusNanos() method

import java.time.*;

public class GFG {
    public static void main(String[] args)
    {

        // create a LocalTime object
        LocalTime time
            = LocalTime.parse("19:34:50.63");

        // print LocalTime
        System.out.println("LocalTime before add: "
                           + time);

        // add 34000000 nanoseconds using plusNanos()
        LocalTime value = time.plusNanos(34000000);

        // print result
        System.out.println("LocalTime after add: "
                           + value);
    }
}

Output:

LocalTime before add: 19:34:50.630
LocalTime after add: 19:34:50.664

Program 2:

// Java program to demonstrate
// LocalTime.plusNanos() method

import java.time.*;

public class GFG {
    public static void main(String[] args)
    {

        // create a LocalTime object
        LocalTime time
            = LocalTime.parse("01:00:01");

        // print LocalTime
        System.out.println("LocalTime before add: "
                           + time);

        // add -971200000 nanoseconds  using plusNanos()
        LocalTime value = time.plusNanos(-971200000);

        // print result
        System.out.println("LocalTime after add: "
                           + value);
    }
}

Output:

LocalTime before add: 01:00:01
LocalTime after add: 01:00:00.028800

References: https://docs.oracle.com/javase/10/docs/api/java/time/LocalTime.html#plusNanos(long)