OffsetDateTime plusNanos() method in Java with examples

The plusNanos() method of OffsetDateTime class in Java returns a copy of this OffsetDateTime with the specified number of nanoseconds added to the parsed date and time.

Syntax:

public OffsetDateTime plusNanos(long nanoseconds)

Parameter: This method accepts a single parameter nanoseconds which specifies the nanoseconds to be added to the parsed date. It can be negative also, in that case, it subtracts the number of nanoseconds to it.

Return Value: It returns an OffsetDateTime based on this date-time with the nanoseconds added and not null.

Exceptions: The program throws a DateTimeException when it exceeds the supported data and time range.

Below programs illustrate the plusNanos() method:

Program 1:

// Java program to demonstrate the plusNanos() method

import java.time.OffsetDateTime;
import java.time.ZonedDateTime;

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

        // Parses the date1
        OffsetDateTime date1
            = OffsetDateTime
                  .parse(
                      "2018-12-12T13:30:30+05:00");

        // Prints dates
        System.out.println("Date1: " + date1);

        // Subtracts the number of nanoseconds
        System.out.println("Date1 after adding nanoseconds: "
                           + date1.plusNanos(-120));
    }
}

Output:

Date1: 2018-12-12T13:30:30+05:00
Date1 after adding nanoseconds: 2018-12-12T13:30:29.999999880+05:00

Program 2:

// Java program to demonstrate the plusNanos() method

import java.time.OffsetDateTime;
import java.time.ZonedDateTime;

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

        // Parses the date1
        OffsetDateTime date1
            = OffsetDateTime
                  .parse(
                      "2018-12-12T13:30:30+05:00");

        // Prints dates
        System.out.println("Date1: " + date1);

        // Subtracts the number of nanoseconds
        System.out.println("Date1 after adding nanoseconds: "
                           + date1.plusNanos(140));
    }
}

Output:

Date1: 2018-12-12T13:30:30+05:00
Date1 after adding nanoseconds: 2018-12-12T13:30:30.000000140+05:00

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