YearMonth minus(long,unit) method in Java with Examples
The minus(long, unit) method of YearMonth class is used to return a copy of this Year-month after subtracting the specified amount of TemporalUnit from this Year-month object.An exception is thrown, If the specified unit cannot be subtracted from Year-month. This instance is immutable and unaffected by this method call.
Syntax:
public YearMonth minus(long amountToSubtract, TemporalUnit unit)
Parameters: This method accepts two parameters:
- amountToSubtract: This parameter represents the amount of the unit to subtract from the result.
- unit: This parameter represents the unit of the amount to subtract.
Return Value: This method returns a Year-month based on this Year-month with the specified amount subtracted.
Exception: This method throws following Exceptions:
- DateTimeException – This exception is thrown if the subtraction cannot be made.
- UnsupportedTemporalTypeException – This exception is thrown if the unit is not supported.
- ArithmeticException – This exception is thrown if numeric overflow occurs.
Below programs illustrate the minus(long, unit) method:
Program 1:
// Java program to demonstrate// YearMonth.minus(long, unit) method  import java.time.*;import java.time.temporal.*;  public class GFG {    public static void main(String[] args)    {        // Create a YearMonth object        YearMonth thisYearMonth = YearMonth.of(2017, 8);          // print instance        System.out.println("YearMonth :"                           + thisYearMonth);          // apply minus(long, unit) method        // subtracting 20 Years        YearMonth value            = thisYearMonth.minus(20, ChronoUnit.YEARS);          // print result        System.out.println("After subtraction YearMonth: "                           + value);    }} |
Output:
YearMonth :2017-08 After subtraction YearMonth: 1997-08
Program 2:
// Java program to demonstrate// YearMonth.minus(long, unit) method  import java.time.*;import java.time.temporal.*;  public class GFG {    public static void main(String[] args)    {        // Create a YearMonth object        YearMonth thisYearMonth = YearMonth.of(2019, 12);          // print instance        System.out.println("YearMonth :"                           + thisYearMonth);          // apply minus(long, unit) method        // subtracting 30 Months        YearMonth value            = thisYearMonth.minus(30, ChronoUnit.MONTHS);          // print result        System.out.println("After subtraction YearMonth: "                           + value);    }} |
Output:
YearMonth :2019-12 After subtraction YearMonth: 2017-06
