Bird
Raised Fist0
JavaHow-ToBeginner · 4 min read

How to Use LocalDate in Java: Syntax and Examples

Use LocalDate in Java to represent a date without time or timezone. You can create instances with LocalDate.now() for the current date or LocalDate.of(year, month, day) for a specific date. It is part of java.time package introduced in Java 8 for easier date handling.
📐

Syntax

LocalDate is a class in the java.time package used to represent a date without time or timezone.

Common ways to create a LocalDate:

  • LocalDate.now() - gets the current date.
  • LocalDate.of(year, month, day) - creates a date for the given year, month, and day.
  • LocalDate.parse("YYYY-MM-DD") - parses a date from a string in ISO format.
java
import java.time.LocalDate;

public class LocalDateSyntax {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        LocalDate specificDate = LocalDate.of(2024, 6, 15);
        LocalDate parsedDate = LocalDate.parse("2024-06-15");

        System.out.println("Today: " + today);
        System.out.println("Specific Date: " + specificDate);
        System.out.println("Parsed Date: " + parsedDate);
    }
}
Output
Today: 2024-06-15 Specific Date: 2024-06-15 Parsed Date: 2024-06-15
💻

Example

This example shows how to create a LocalDate for today, a birthday, and how to calculate the number of days between two dates.

java
import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

public class LocalDateExample {
    public static void main(String[] args) {
        LocalDate today = LocalDate.now();
        LocalDate birthday = LocalDate.of(1990, 12, 25);

        long daysBetween = ChronoUnit.DAYS.between(birthday, today);

        System.out.println("Today's date: " + today);
        System.out.println("Birthday: " + birthday);
        System.out.println("Days since birthday: " + daysBetween);
    }
}
Output
Today's date: 2024-06-15 Birthday: 1990-12-25 Days since birthday: 12226
⚠️

Common Pitfalls

Common mistakes when using LocalDate include:

  • Confusing LocalDate with LocalDateTime which includes time.
  • Using deprecated Date or Calendar classes instead of LocalDate.
  • Parsing dates with wrong formats causing exceptions.
  • Not handling exceptions when parsing strings.

Always use ISO format (YYYY-MM-DD) for parsing or provide a formatter.

java
import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;

public class LocalDateParsing {
    public static void main(String[] args) {
        try {
            // Wrong format - will throw exception
            LocalDate wrongDate = LocalDate.parse("15-06-2024");
        } catch (DateTimeParseException e) {
            System.out.println("Parsing failed: " + e.getMessage());
        }

        // Correct parsing with formatter
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd-MM-yyyy");
        LocalDate correctDate = LocalDate.parse("15-06-2024", formatter);
        System.out.println("Parsed with formatter: " + correctDate);
    }
}
Output
Parsing failed: Text '15-06-2024' could not be parsed at index 0 Parsed with formatter: 2024-06-15
📊

Quick Reference

MethodDescription
LocalDate.now()Gets the current date from the system clock.
LocalDate.of(year, month, day)Creates a date with specified year, month, and day.
LocalDate.parse(String)Parses a date from a string in ISO format (YYYY-MM-DD).
LocalDate.parse(String, DateTimeFormatter)Parses a date from a string using a custom format.
plusDays(long)Returns a new LocalDate with days added.
minusMonths(long)Returns a new LocalDate with months subtracted.
isBefore(LocalDate)Checks if this date is before another date.
isAfter(LocalDate)Checks if this date is after another date.
✅

Key Takeaways

Use LocalDate to represent dates without time or timezone in Java.
Create LocalDate instances with now(), of(), or parse() methods.
Always parse strings in ISO format or use a DateTimeFormatter for custom formats.
Avoid mixing LocalDate with legacy Date or Calendar classes.
Use ChronoUnit to calculate differences between LocalDate instances.