Sunday, January 18, 2026
HomeLanguagesJavaLocalDate minusWeeks() method in Java with Examples

LocalDate minusWeeks() method in Java with Examples

The minusWeeks() method of a LocalDate class in Java is used to subtract the number of specified week from this LocalDate and return a copy of LocalDate.For example, 2018-12-24 minus one week would result in 2018-12-17. This instance is immutable and unaffected by this method call.

Syntax:

public LocalDate minusWeeks(long weeksToSubtract)

Parameters: This method accepts a single parameter weeksToSubtract which represents the weeks to subtract, may be negative.

Return Value: This method returns a LocalDate based on this date with the weeks subtracted, not null.

Exception: This method throws DateTimeException if the result exceeds the supported date range.

Below programs illustrate the minusWeeks() method:

Program 1:




// Java program to demonstrate
// LocalDate.minusWeeks() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a LocalDate object
        LocalDate date
            = LocalDate.parse("2018-12-26");
  
        // print instance
        System.out.println("LocalDate before"
                           + " subtracting weeks: " + date);
  
        // subtract 2 weeks
        LocalDate returnvalue
            = date.minusWeeks(2);
  
        // print result
        System.out.println("LocalDate after "
                           + " subtracting weeks: " + returnvalue);
    }
}


Output:

LocalDate before subtracting weeks: 2018-12-26
LocalDate after  subtracting weeks: 2018-12-12

Program 2:




// Java program to demonstrate
// LocalDate.minusWeeks() method
  
import java.time.*;
  
public class GFG {
    public static void main(String[] args)
    {
  
        // create a LocalDate object
        LocalDate date
            = LocalDate.parse("2018-12-24");
  
        // print instance
        System.out.println("LocalDate before"
                           + " subtracting weeks: " + date);
  
        // subtract -13 weeks
        LocalDate returnvalue
            = date.minusWeeks(-13);
  
        // print result
        System.out.println("LocalDate after "
                           + " subtracting weeks: " + returnvalue);
    }
}


Output:

LocalDate before subtracting weeks: 2018-12-24
LocalDate after  subtracting weeks: 2019-03-25

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

RELATED ARTICLES

3 COMMENTS

Most Popular

Dominic
32474 POSTS0 COMMENTS
Milvus
118 POSTS0 COMMENTS
Nango Kala
6846 POSTS0 COMMENTS
Nicole Veronica
11977 POSTS0 COMMENTS
Nokonwaba Nkukhwana
12063 POSTS0 COMMENTS
Shaida Kate Naidoo
6985 POSTS0 COMMENTS
Ted Musemwa
7219 POSTS0 COMMENTS
Thapelo Manthata
6933 POSTS0 COMMENTS
Umr Jansen
6911 POSTS0 COMMENTS