Friday, June 19, 2026
HomeLanguagesJavaOffsetDateTime withSecond() method in Java with examples

OffsetDateTime withSecond() method in Java with examples

The withSecond() method of OffsetDateTime class in Java returns a copy of this OffsetDateTime with the second-of-minute altered as specified in the parameter.

Syntax:

public OffsetDateTime withSecond(int second)

Parameter: This method accepts a single parameter second which specifies the second-of-minute to be set in the result which can range from 0 to 59.

Return Value: It returns a OffsetDateTime based on this date with the requested second-of-minute and not null.

Exceptions: The program throws a DateTimeException when the second-of-minute value is invalid.

Below programs illustrate the withSecond() method:

Program 1:




// Java program to demonstrate the withSecond() method
  
import java.time.OffsetDateTime;
  
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);
  
        // Changes the second-of-minute
        System.out.println("Date1 after altering second-of-minute: "
                           + date1.withSecond(40));
    }
}


Output:

Date1: 2018-12-12T13:30:30+05:00
Date1 after altering second-of-minute : 2018-12-12T13:30:40+05:00

Program 2:




// Java program to demonstrate the withSecond() method
  
import java.time.OffsetDateTime;
  
public class GFG {
    public static void main(String[] args)
    {
        try {
  
            // Parses the date1
            OffsetDateTime date1
                = OffsetDateTime
                      .parse(
                          "2018-12-12T13:30:30+05:00");
  
            // Prints dates
            System.out.println("Date1: " + date1);
  
            // Changes the second-of-minute
            System.out.println("Date1 after altering second-of-minute: "
                               + date1.withSecond(70));
        }
        catch (Exception e) {
            System.out.println("Exception: " + e);
        }
    }
}


Output:

Date1: 2018-12-12T13:30:30+05:00
Exception: java.time.DateTimeException:
           Invalid value for SecondOfMinute (valid values 0 - 59): 70

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

RELATED ARTICLES

Most Popular

Dominic
32516 POSTS0 COMMENTS
Milvus
131 POSTS0 COMMENTS
Nango Kala
6898 POSTS0 COMMENTS
Nicole Veronica
12014 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12110 POSTS0 COMMENTS
Shaida Kate Naidoo
7019 POSTS0 COMMENTS
Ted Musemwa
7262 POSTS0 COMMENTS
Thapelo Manthata
6976 POSTS0 COMMENTS
Umr Jansen
6965 POSTS0 COMMENTS