Java LocalTime minusMinutes()

In this guide, you will learn about the LocalTime minusMinutes() method in Java programming and how to use it with an example.

1. LocalTime minusMinutes() Method Overview

Definition:

The minusMinutes() method of the LocalTime class in Java is used to subtract the specified number of minutes from the LocalTime instance, resulting in a new LocalTime object representing the updated time.

Syntax:

public LocalTime minusMinutes(long minutesToSubtract)

Parameters:

- minutesToSubtract: the minutes to subtract, may be negative.

Key Points:

- The minusMinutes() method returns a new LocalTime instance with the specified minutes subtracted from the original time.

- The original LocalTime object remains unmodified, as LocalTime instances are immutable.

- If the subtraction results in a time before midnight, the time value wraps around.

- The method does not affect the hour, second, or nanosecond values of the LocalTime.

- If minutesToSubtract is negative, the method effectively adds the absolute value of the minutes to the current time.

2. LocalTime minusMinutes() Method Example

import java.time.LocalTime;

public class LocalTimeMinusMinutesExample {
    public static void main(String[] args) {
        // Get the current LocalTime
        LocalTime currentTime = LocalTime.now();
        System.out.println("Current Local Time: " + currentTime);

        // Subtract 30 minutes from the current LocalTime
        LocalTime timeAfterSubtractingMinutes = currentTime.minusMinutes(30);
        System.out.println("Local Time After Subtracting 30 Minutes: " + timeAfterSubtractingMinutes);

        // Add 15 minutes to the current LocalTime using negative parameter
        LocalTime timeAfterAddingMinutes = currentTime.minusMinutes(-15);
        System.out.println("Local Time After Adding 15 Minutes: " + timeAfterAddingMinutes);
    }
}

Output:

Current Local Time: 10:15:30.123456789 (example time, actual output will vary)
Local Time After Subtracting 30 Minutes: 09:45:30.123456789
Local Time After Adding 15 Minutes: 10:30:30.123456789

Explanation:

In this example, we first retrieve the current LocalTime and print it to the console. 

We then use the minusMinutes() method to subtract 30 minutes from the current time, resulting in a new LocalTime instance which is printed to the console. 

Subsequently, we demonstrate the addition of minutes by passing a negative value to minusMinutes(), adding 15 minutes to the current time, and printing the resulting LocalTime to the console.