Java LocalDateTime minusMinutes() Method

📘 Premium Read: Access my best content on Medium member-only articles — deep dives into Java, Spring Boot, Microservices, backend architecture, interview preparation, career advice, and industry-standard best practices.

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (176K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

The minusMinutes() method in Java, part of the java.time.LocalDateTime class, is used to subtract a specified number of minutes from a LocalDateTime instance. This method is useful for manipulating date-time values by subtracting minutes.

Table of Contents

1. Introduction
2. minusMinutes() Method Syntax
3. Understanding minusMinutes()
4. Examples
   • Basic Usage
   • Using minusMinutes() in Conditional Statements
5. Real-World Use Case
6. Conclusion

Introduction

The minusMinutes() method allows you to subtract a specified number of minutes from a LocalDateTime instance. This is particularly useful when you need to calculate past times based on a given LocalDateTime.

minusMinutes() Method Syntax

The syntax for the minusMinutes() method is as follows:

public LocalDateTime minusMinutes(long minutes) 

Parameters:

• minutes: The number of minutes to subtract, may be negative.

Returns:

• A LocalDateTime based on this date-time with the specified minutes subtracted, not null.

Throws:

• DateTimeException if the result exceeds the supported date range.
• ArithmeticException if numeric overflow occurs.

Understanding minusMinutes()

The minusMinutes() method subtracts the specified number of minutes from the LocalDateTime instance and returns a new LocalDateTime instance representing the adjusted date-time. This method is immutable and does not modify the original LocalDateTime instance.

Examples

Basic Usage

To demonstrate the basic usage of minusMinutes(), we will subtract a specified number of minutes from a LocalDateTime instance.

Example

import java.time.LocalDateTime; public class LocalDateTimeMinusMinutesExample { public static void main(String[] args) { LocalDateTime dateTime = LocalDateTime.of(2023, 6, 15, 10, 30); LocalDateTime newDateTime = dateTime.minusMinutes(45); // Subtract 45 minutes System.out.println("Original DateTime: " + dateTime); System.out.println("New DateTime: " + newDateTime); } } 

Output:

Original DateTime: 2023-06-15T10:30 New DateTime: 2023-06-15T09:45 

Using minusMinutes() in Conditional Statements

This example shows how to use the minusMinutes() method in conditional statements to perform actions based on the adjusted date-time.

Example

import java.time.LocalDateTime; public class LocalDateTimeConditionalExample { public static void main(String[] args) { LocalDateTime currentDateTime = LocalDateTime.now(); LocalDateTime pastDateTime = currentDateTime.minusMinutes(30); // Subtract 30 minutes if (pastDateTime.isBefore(currentDateTime)) { System.out.println("The past date-time is before the current date-time."); } else { System.out.println("The past date-time is not before the current date-time."); } } } 

Output:

The past date-time is before the current date-time. 

Real-World Use Case

Calculating Past Times

In real-world applications, the minusMinutes() method can be used to calculate past times, such as determining a time that is a certain number of minutes before a given time.

Example

import java.time.LocalDateTime; public class PastTimeCalculatorExample { public static void main(String[] args) { LocalDateTime meetingTime = LocalDateTime.of(2023, 12, 1, 10, 0); LocalDateTime reminderTime = meetingTime.minusMinutes(15); // Subtract 15 minutes for a reminder System.out.println("Meeting Time: " + meetingTime); System.out.println("Reminder Time: " + reminderTime); } } 

Output:

Meeting Time: 2023-12-01T10:00 Reminder Time: 2023-12-01T09:45 

Conclusion

The LocalDateTime.minusMinutes() method is used to subtract a specified number of minutes from a LocalDateTime instance. This method is particularly useful for calculating past times. By understanding and using the minusMinutes() method, you can effectively manage and manipulate date-time data in your Java applications.