Course contentsShow
← Java
Lesson 1887 of 2,87038. Date and Time API (java.time)Free lesson

Formatting Temporal Objects to Strings

Converting LocalDate, LocalDateTime, ZonedDateTime to formatted strings using the format method.

Formatting Temporal Objects to Strings

You'll learn how to convert date/time objects like LocalDate, LocalDateTime, and ZonedDateTime into human-readable strings using the format method.


The Core Idea

Once you have a temporal object (a date, time, or both), you often need to display it to users or write it to logs. The format() method takes a DateTimeFormatter and transforms your temporal object into a formatted string according to the pattern you've specified.

Think of it like translating computer date-speak into human language. A LocalDate might be stored internally in a structured way, but you want to show "March 15, 2024" or "2024-03-15" depending on your audience.

How format() Works

Every temporal class (LocalDate, LocalDateTime, ZonedDateTime, etc.) has a format() method. You pass it a DateTimeFormatter (either built-in or custom), and it returns a String:

LocalDate date = LocalDate.of(2024, 3, 15);
String formatted = date.format(DateTimeFormatter.ISO_LOCAL_DATE);
// Result: "2024-03-15"

Examples with Different Temporal Types

LocalDateTime dateTime = LocalDateTime.of(2024, 3, 15, 14, 30);
String result = dateTime.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm"));
// Result: "2024-03-15 14:30"

ZonedDateTime zoned = ZonedDateTime.now();
String withZone = zoned.format(DateTimeFormatter.ofPattern("MM/dd/yyyy hh:mm a z"));
// Result: "03/15/2024 02:30 PM PST" (example)

The format() method respects the pattern you defined with ofPattern() or uses the structure of built-in formatters like ISO_LOCAL_DATE.


Key Takeaway: Use the format(DateTimeFormatter) method on any temporal object to convert it into a formatted string, making dates and times readable for display or logging purposes.