Thursday, June 11, 2026
HomeLanguagesJavaOffsetDateTime plusNanos() method in Java with examples

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)

RELATED ARTICLES

2 COMMENTS

Most Popular

Dominic
32515 POSTS0 COMMENTS
Milvus
131 POSTS0 COMMENTS
Nango Kala
6896 POSTS0 COMMENTS
Nicole Veronica
12012 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12109 POSTS0 COMMENTS
Shaida Kate Naidoo
7019 POSTS0 COMMENTS
Ted Musemwa
7262 POSTS0 COMMENTS
Thapelo Manthata
6976 POSTS0 COMMENTS
Umr Jansen
6963 POSTS0 COMMENTS