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

Method	Description
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.