last modified January 10, 2023

Java LocalDate tutorial shows how to work with LocalDate in Java. We compute the current local date, parse local date, format local date, compare local date, and do date arithmetics.

LocalDate is a date without a time-zone in the ISO-8601 calendar system, such as 2021-05-22. LocalDate is an immutable date-time object.

LocalDate does not store or represent a time or time-zone. It is a description of the local date as seen on a wall clock.

The equals method should be used for comparisons.

The current date is retrived with LocalDate.now.

The example prints the local current date.

The are several ways to create LocalDate in Java.

The example presents four methods to generate a LocalDate.

The LocalDate.now creates a current local time.

With LocalDate.of, we can create a specific local date from an year, month, and date values.

With LocalDate.parse, we parse LocalDate from a string.

It is also possible to get LocalDate from a LocalDateTime object using the toLocalDate method.

The following example splits a local date into year, month, and day parts.

The getYear gets the year, the getMonthValue gets the month, and the getDayOfMonth the day of the date.

In the following example, we get the day of year, month, and week.

To do the task, we use the getDayOfYear, getDayOfMonth, and getDayOfWeek methods.

Different countries use different date formats. DateTimeFormatter helps us format the date.

The example uses DateTimeFormatter to format date.

We format the time to the ISO_DATE format date standart.

We can choose a custom date format with DateTimeFormatter.ofPattern. The documentation to DateTimeFormatter contains the description of various formatting characters that we can use.

With the ofLocalizedDate method, we have a locale specific date format.

Java LocalDate has methods for doing date arithmetics.

The example presents method for adding and subtracting date units.

The plusDays adds three days to the current local date.

Likewise, the minusDays subtracts three days from the current local date.

With the until method, we can compute the date until another date in terms of the specified unit.

The example calculates the date that has to elapse until another date in days, months and years.

With ChronoUnit.DAYS, we specify that we calculate the the date difference in days.

The following example shows how to compare dates.

The example compares dates. We check if they are equal, if the come before or after another date.

The compareTo compares two local dates.

The isBefore checks if a date comes before another date.

The isAfter checks if a date comes after another date.

The datesUntil method returns a sequential ordered stream of dates. The returned stream starts from start date (inclusive) and goes to end date (exclusive) by an incremental step of one day.

In the example, we print all dates between two specified dates.

The range method gets the range of valid values for the specified field.

We get the range for various fields including DAY_OF_MONTH, YEAR, and DAY_OF_YEAR.

The query method queries a date using the specified query. They are used for extracting information from temporal objects.

In the example, we check if family members have birthdays in the specified dates.

We have a list of dates.

We go over the list and check if each element is a family birthday with checkBirthday.

We query the current date with the query method; we pass the method a TemporalQuery.

Inside the TemporalQuery's queryFrom method we specify the dates (birthdays), for which the method returns true.

In this article, we have worked with Java LocalDate.

List all Java tutorials.