Java Duration plusMinutes() Method

The plusMinutes() method in Java, part of the java.time.Duration class, is used to add a specified number of minutes to a Duration instance. This method is useful for calculating durations that are a specified number of minutes longer than the original duration.

Table of Contents

  1. Introduction
  2. plusMinutes() Method Syntax
  3. Understanding plusMinutes()
  4. Examples
    • Basic Usage
    • Handling Negative and Large Minute Values
  5. Real-World Use Case
  6. Conclusion

Introduction

The plusMinutes() method allows you to add a specified number of minutes to an existing Duration instance. This is particularly useful when you need to adjust a duration by a specific number of minutes, such as extending an interval or adding additional minutes to a task.

plusMinutes() Method Syntax

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

public Duration plusMinutes(long minutesToAdd)

Parameters:

  • minutesToAdd: The number of minutes to add, which can be positive or negative.

Returns:

  • A Duration that is the result of adding the specified number of minutes to the original duration.

Throws:

  • This method does not throw any exceptions.

Understanding plusMinutes()

The plusMinutes() method creates a new Duration instance by adding the specified number of minutes to the original duration. The result is a new Duration object representing the adjusted time span.

Examples

Basic Usage

To demonstrate the basic usage of plusMinutes(), we will add a specified number of minutes to an existing Duration instance.

Example

import java.time.Duration;

public class DurationPlusMinutesExample {
    public static void main(String[] args) {
        Duration originalDuration = Duration.ofHours(1);
        Duration addedDuration = originalDuration.plusMinutes(30);

        System.out.println("Original duration: " + originalDuration);
        System.out.println("Added duration: " + addedDuration);
    }
}

Output:

Original duration: PT1H
Added duration: PT1H30M

Handling Negative and Large Minute Values

This example shows how to use plusMinutes() to handle negative and large minute values.

Example

import java.time.Duration;

public class NegativeAndLargeMinutesExample {
    public static void main(String[] args) {
        Duration duration = Duration.ofHours(1);

        // Add a negative number of minutes
        Duration negativeResult = duration.plusMinutes(-15);
        System.out.println("After adding -15 minutes: " + negativeResult);

        // Add a large number of minutes
        Duration largeResult = duration.plusMinutes(90);
        System.out.println("After adding 90 minutes: " + largeResult);
    }
}

Output:

After adding -15 minutes: PT45M
After adding 90 minutes: PT2H30M

Real-World Use Case

Extending Task Durations

In real-world applications, the plusMinutes() method can be used to extend task durations, such as adding additional minutes to a task or extending a deadline by a certain number of minutes.

Example

import java.time.Duration;

public class TaskDurationExtensionExample {
    public static void main(String[] args) {
        Duration originalDuration = Duration.ofMinutes(90);
        long extraMinutes = 30;

        // Extend the original duration by adding extra minutes
        Duration extendedDuration = originalDuration.plusMinutes(extraMinutes);

        System.out.println("Original duration: " + originalDuration);
        System.out.println("Extended duration: " + extendedDuration);
    }
}

Output:

Original duration: PT1H30M
Extended duration: PT2H

Conclusion

The Duration.plusMinutes() method is used to add a specified number of minutes to a Duration instance. This method is particularly useful for adjusting durations by a specific number of minutes. By understanding and using this method, you can effectively manage and manipulate time-based data in your Java applications.

Continue Learning with Java Guides

Want to take your programming skills to the next level? Explore my practical Udemy courses on Java, Spring Boot, Microservices, Full-Stack Development, Docker, and Generative AI. You can also follow my structured learning roadmaps to become a professional developer.

By Ramesh Fadatare - Udemy Instructor Partner

Comments