Java – Format LocalTime to HH:mm:ss

Introduction

When working with time values in Java, you might need to format a LocalTime object into a specific string format, such as HH:mm:ss. This format represents hours, minutes, and seconds, and is commonly used in various applications, particularly for displaying or logging time values. Java 8’s java.time package provides the DateTimeFormatter class, which makes formatting time values simple and efficient.

In this guide, we’ll explore how to format a LocalTime to the HH:mm:ss pattern using Java 8’s DateTimeFormatter class.

Table of Contents

• Problem Statement
• Solution Steps
• Java Program
  • Formatting LocalTime to HH:mm:ss
  • Parsing a HH:mm:ss String Back to LocalTime
• Advanced Considerations
• Conclusion

Problem Statement

The task is to create a Java program that:

• Converts a LocalTime object to a string formatted as HH:mm:ss.
• Optionally, parses a string in the HH:mm:ss format back into a LocalTime object.

Example:

• Input: A LocalTime object representing 14:30:45.
• Output: A string formatted as 14:30:45.

Solution Steps

1. Use DateTimeFormatter.ofPattern(): Define a formatter with the HH:mm:ss pattern.
2. Format the LocalTime: Use the format() method of LocalTime with the defined formatter.
3. Parse the String: Convert a HH:mm:ss formatted string back to a LocalTime using the same formatter.

Java Program

Formatting LocalTime to HH:mm:ss

You can format a LocalTime to the HH:mm:ss format using the DateTimeFormatter class.

import java.time.LocalTime;
import java.time.format.DateTimeFormatter;

/**
 * Java - Format LocalTime to HH:mm:ss
 * Author: https://www.rameshfadatare.com/
 */
public class FormatLocalTime {

    public static void main(String[] args) {
        // Step 1: Create a LocalTime object
        LocalTime time = LocalTime.of(14, 30, 45);

        // Step 2: Define the DateTimeFormatter with the desired pattern
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("HH:mm:ss");

        // Step 3: Format the LocalTime to a string
        String formattedTime = time.format(formatter);

        // Step 4: Display the formatted time
        System.out.println("Formatted Time: " + formattedTime);
    }
}

Output

Formatted Time: 14:30:45

Explanation

• DateTimeFormatter.ofPattern("HH:mm:ss") creates a formatter that follows the HH:mm:ss pattern.
• time.format(formatter) converts the LocalTime into a string formatted as HH:mm:ss.

Parsing a HH:mm:ss String Back to LocalTime

If you have a time string in the HH:mm:ss format, you can parse it back into a LocalTime object using the same formatter.

import java.time.LocalTime;
import java.time.format.DateTimeFormatter;

/**
 * Java - Parse String in HH:mm:ss to LocalTime
 * Author: https://www.rameshfadatare.com/
 */
public class ParseTimeString {

    public static void main(String[] args) {
        // Step 1: Define a time string in the HH:mm:ss format
        String timeString = "14:30:45";

        // Step 2: Define the DateTimeFormatter with the desired pattern
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("HH:mm:ss");

        // Step 3: Parse the string to a LocalTime
        LocalTime time = LocalTime.parse(timeString, formatter);

        // Step 4: Display the LocalTime
        System.out.println("Parsed LocalTime: " + time);
    }
}

Output

Parsed LocalTime: 14:30:45

Explanation

• DateTimeFormatter.ofPattern("HH:mm:ss") is used to define the pattern that matches the input string.
• LocalTime.parse(timeString, formatter) converts the string back to a LocalTime object using the formatter.

Advanced Considerations

• 24-Hour vs. 12-Hour Time: The HH:mm:ss pattern represents a 24-hour clock. If you need a 12-hour clock with AM/PM, use hh:mm:ss a as the pattern and ensure that your input includes the AM/PM designator.

• Validation: Ensure that your input strings strictly follow the HH:mm:ss pattern. Any deviation in the format will result in a DateTimeParseException.

• Immutability: The LocalTime and DateTimeFormatter classes are immutable and thread-safe, making them ideal for use in concurrent applications.

Conclusion

This guide provides methods for formatting a LocalTime to the HH:mm:ss pattern in Java, as well as parsing a string in this format back to a LocalTime. The DateTimeFormatter class offers a flexible and powerful way to handle custom time formats, ensuring that your Java applications can easily convert between LocalTime objects and formatted time strings.