Thursday, September 18, 2025
HomeLanguagesJavaDayOfWeek minus() method in Java with Examples

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-

    RELATED ARTICLES

    Most Popular

    Dominic
    32299 POSTS0 COMMENTS
    Milvus
    84 POSTS0 COMMENTS
    Nango Kala
    6663 POSTS0 COMMENTS
    Nicole Veronica
    11835 POSTS0 COMMENTS
    Nokonwaba Nkukhwana
    11895 POSTS0 COMMENTS
    Shaida Kate Naidoo
    6779 POSTS0 COMMENTS
    Ted Musemwa
    7053 POSTS0 COMMENTS
    Thapelo Manthata
    6736 POSTS0 COMMENTS
    Umr Jansen
    6742 POSTS0 COMMENTS