Thursday, June 11, 2026
HomeLanguagesJavaLocalTime withNano() method in Java with Examples

LocalTime withNano() method in Java with Examples

The withNano() method of a LocalTime class is used to get a copy of this LocalTime with the nanos changed to the nanos passed as the parameter to this method. The remaining values of this LocalTime will remain the same. This instance is immutable and unaffected by this method call.

Syntax:

public LocalTime withNano(int nano)

Parameters: This method accepts a single parameter nano which represents the nano-of-second to set in the result, from 0 to 999, 999, 999.

Return value: This method returns a LocalTime instance based on this time with the requested nano.

Exception: This method throws a exception DateTimeException if the nano value is invalid

Below programs illustrate the withNano() method:

Program 1:




// Java program to demonstrate
// LocalTime.withNano() 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 time
        System.out.println("Old LocalTime: "
                           + time);
  
        // Get a new LocalDateTime with nanos 100000
        LocalTime newtime = time.withNano(100000);
  
        // print result
        System.out.println("New LocalDateTime: "
                           + newtime);
    }
}


Output:

Old LocalTime: 19:34:50.630
New LocalDateTime: 19:34:50.000100

Program 2:




// Java program to demonstrate
// LocalTime.withNano() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a LocalTime object
        LocalTime time
            = LocalTime.parse("01:21:30.13");
  
        // print time
        System.out.println("Old LocalTime: "
                           + time);
  
        // Get a new LocalDateTime with nanos 999999
        LocalTime newtime = time.withNano(999999);
  
        // print result
        System.out.println("New LocalDateTime: "
                           + newtime);
    }
}


Output:

Old LocalTime: 01:21:30.130
New LocalDateTime: 01:21:30.000999999

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

RELATED ARTICLES

3 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