Java Duration plusSeconds() 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 plusSeconds() method in Java, part of the java.time.Duration class, is used to add a specified number of seconds to a Duration instance. This method is useful for calculating durations that are a specified number of seconds longer than the original duration.

Table of Contents

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

Introduction

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

plusSeconds() Method Syntax

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

public Duration plusSeconds(long secondsToAdd) 

Parameters:

• secondsToAdd: The number of seconds to add, which can be positive or negative.

Returns:

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

Throws:

• This method does not throw any exceptions.

Understanding plusSeconds()

The plusSeconds() method creates a new Duration instance by adding the specified number of seconds 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 plusSeconds(), we will add a specified number of seconds to an existing Duration instance.

Example

import java.time.Duration; public class DurationPlusSecondsExample { public static void main(String[] args) { Duration originalDuration = Duration.ofMinutes(1); Duration addedDuration = originalDuration.plusSeconds(30); System.out.println("Original duration: " + originalDuration); System.out.println("Added duration: " + addedDuration); } } 

Output:

Original duration: PT1M Added duration: PT1M30S 

Handling Negative and Large Second Values

This example shows how to use plusSeconds() to handle negative and large second values.

Example

import java.time.Duration; public class NegativeAndLargeSecondsExample { public static void main(String[] args) { Duration duration = Duration.ofMinutes(1); // Add a negative number of seconds Duration negativeResult = duration.plusSeconds(-30); System.out.println("After adding -30 seconds: " + negativeResult); // Add a large number of seconds Duration largeResult = duration.plusSeconds(120); System.out.println("After adding 120 seconds: " + largeResult); } } 

Output:

After adding -30 seconds: PT30S After adding 120 seconds: PT3M 

Real-World Use Case

Extending Task Durations

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

Example

import java.time.Duration; public class TaskDurationExtensionExample { public static void main(String[] args) { Duration originalDuration = Duration.ofSeconds(90); long extraSeconds = 45; // Extend the original duration by adding extra seconds Duration extendedDuration = originalDuration.plusSeconds(extraSeconds); System.out.println("Original duration: " + originalDuration); System.out.println("Extended duration: " + extendedDuration); } } 

Output:

Original duration: PT1M30S Extended duration: PT2M15S 

Conclusion

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