DayOfWeek minus() method in Java with Examples

Last Updated : 19 Mar, 2019

The minus() method of java.time.DayOfWeek is an in-built function in Java which takes a long integer as parameter and returns an instance of DayOfWeek after advancing some days backward or forward as specified by the passed parameter. The calculation rolls around the end of the week from Monday to Sunday. The specified period may be positive or negative.

Method Declaration:

public DayOfWeek minus(long days)

Syntax:

DayOfWeek dayOfWeekObject = dayOfWeekObject.minus(long days)

Parameters: This method takes days as parameter where:

days – is the number of days to advance forward or backward.

dayOfWeekObject – is an instance of DayOfWeek object.

Return Value: The function returns an instance of DayOfWeek after advancing by some days backward or forward.

Below programs illustrate the above method:
Program 1:

// Java Program Demonstrate minus()
// method of DayOfWeek
import java.time.DayOfWeek;
  
class DayOfWeekExample {
    public static void main(String[] args)
    {
        // Getting an instance of DayOfWeek from int value
        DayOfWeek dayOfWeek = DayOfWeek.of(2);
  
        // Printing the day of the week and its Int value
        System.out.println("Day of the Week : "
                           + dayOfWeek.name() + " - "
                           + dayOfWeek.getValue());
  
        // Number of days to advance
        long adv = 10;
  
        // Advancing the day
        dayOfWeek = dayOfWeek.minus(adv);
  
        // Printing the day of the week and its
        // Int value before adv days
        System.out.println("Day of the Week before "
                           + adv + " days: "
                           + dayOfWeek.name() + " - "
                           + dayOfWeek.getValue());
    }
}

Output:

Day of the Week : TUESDAY - 2
Day of the Week before 10 days: SATURDAY - 6

Program 2:

// Java Program Demonstrate minus()
// method of DayOfWeek
import java.time.DayOfWeek;
  
class DayOfWeekExample {
    public static void main(String[] args)
    {
        // Getting an instance of DayOfWeek
        // from int value
        DayOfWeek dayOfWeek = DayOfWeek.of(7);
  
        // Printing the day of the week
        // and its Int value
        System.out.println("Day of the Week : "
                           + dayOfWeek.name()
                           + " - "
                           + dayOfWeek.getValue());
  
        // Number of days to advance
        long adv = -3;
  
        // Advancing the day
        dayOfWeek = dayOfWeek.minus(adv);
  
        // Printing the day of the week and its
        // Int value before adv days
        System.out.println("Day of the Week before "
                           + adv + " days: "
                           + dayOfWeek.name()
                           + " - "
                           + dayOfWeek.getValue());
    }
}

Output:

Day of the Week : SUNDAY - 7
Day of the Week before -3 days: WEDNESDAY - 3

Reference: https://docs.oracle.com/javase/8/docs/api/java/time/DayOfWeek.html#minus-long-

Attention reader! Don’t stop learning now. Get hold of all the important Java Foundation and Collections concepts with the Fundamentals of Java and Java Collections Course at a student-friendly price and become industry ready. To complete your preparation from learning a language to DS Algo and many more, please refer Complete Interview Preparation Course.

My Personal Notes

Related Articles

DayOfWeek minus() method in Java with Examples