DayOfWeek minus() method in Java with Examples

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-

My Personal Notes

Recommended Posts: