Java LocalTime minusMinutes()

🎓 Check Out My Top 25 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare

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.