Java LocalDate class

Java LocalDate class belongs to the java.time package and is part of the Date and Time API (e.g., JSR-310) that was added to Java 8. It expresses a date without a time component (year, month, and day) in the ISO-8601 time format. Java LocalDate class is an immutable class that represents Date with a default format of yyyy-mm-dd. It inherits the Object class and implements the ChronoLocalDate interface.

Java LocalDate Class Declaration

Let's see the declaration of java.time.LocalDate class.

public final class LocalDate extends Object 
implements Temporal, TemporalAdjuster, ChronoLocalDate, Serializable

Methods of Java LocalDate

Method	Description
LocalDateTime atTime(int hour, int minute)	It is used to combine this date with a time to create a LocalDateTime.
int compareTo(ChronoLocalDate other)	It is used to compares this date to another date.
boolean equals(Object obj)	It is used to check if this date is equal to another date.
String format(DateTimeFormatter formatter)	It is used to format this date using the specified formatter.
int get(TemporalField field)	It is used to get the value of the specified field from this date as an int.
boolean isLeapYear()	It is used to check if the year is a leap year, according to the ISO proleptic calendar system rules.
LocalDate minusDays(long daysToSubtract)	It is used to return a copy of this LocalDate with the specified number of days subtracted.
LocalDate minusMonths(long monthsToSubtract)	It is used to return a copy of this LocalDate with the specified number of months subtracted.
static LocalDate now()	It is used to obtain the current date from the system clock in the default time-zone.
LocalDate plusDays(long daysToAdd)	It is used to return a copy of this LocalDate with the specified number of days added.
LocalDate plusMonths(long monthsToAdd)	It is used to return a copy of this LocalDate with the specified number of months added.
LocalDate plusMonths(long monthsToAdd)	It is used to return a copy of this LocalDate with the specified number of months added.
int getDayOfMonth()	It gets the day-of-month field.
DayOfWeek getDayOfWeek()	It gets the day-of-week field, which is an enum DayOfWeek.
int getDayOfYear()	It gets the day-of-year field.
Month getMonth()	It gets the month-of-year field using the Month enum.
int getMonthValue()	It gets the month-of-year field from 1 to 12.
int getYear()	It gets the year field.
int lengthOfMonth()	It returns the length of the month represented by this date.
int lengthOfYear()	It returns the length of the year represented by this date.
static LocalDate ofYearDay(int year, int dayOfYear)	It obtains an instance of LocalDate from a year and day-of-year.
static LocalDate parse(CharSequence text)	It obtains an instance of LocalDate from a text string such as 2007-12-03
static LocalDate parse(CharSequence text, DateTimeFormatter formatter)	It obtains an instance of LocalDate from a text string using a specific formatter.

Creation of LocalDate Objects

Using the now() method to get the current date: The LocalDate class's now() method retrieves the current date relative to the system clock in the default time-zone. It provides a quick and easy means of retrieving the current date without the need to specify any parameter or time-zone details.

LocalDateExample.java

import java.time.LocalDate;
public class LocalDateExample{
    public static void main(String[] args) {
        // Using now() to get the current date
        LocalDate currentDate = LocalDate.now();      
        // Printing the current date
        System.out.println("Current Date: " + currentDate);
    }
}

Output:

Current Date: 2024-03-22

Parsing from a String: To extract a LocalDate from a string in Java, you can use the parse() method. This is done through a method that takes a string representing a date and converts it into a LocalDate object. The string should be in the ISO-8601 format (yyyy-MM-dd) or a format that can be parsed using the Default DateTimeFormatter.

GetLocalDate.java

import java.time.LocalDate;
public class GetLocalDate{
    public static void main(String[] args) {
        // String representing a date
        String dateString = "2024-03-22";
        // Parsing the date from the string
        LocalDate parsedDate = LocalDate.parse(dateString);
        // Printing the parsed date
        System.out.println("Parsed Date: " + parsedDate);
    }
}

Output:

Parsed Date: 2024-03-22

Providing year, month, and day directly: You can use the of() method of the LocalDate class to create a LocalDate object by giving the year, month, and day values directly. This approach extracts the year, month, and day-of-month as its arguments and returns a LocalDate object signifying the indicated date.

LocalDateExample.java

import java.time.LocalDate;
public class LocalDateExample {
    public static void main(String[] args) {
        // Providing year, month, and day directly
        int year = 2024;
        int month = 3;
        int dayOfMonth = 22;
        // Creating a LocalDate object
        LocalDate customDate = LocalDate.of(year, month, dayOfMonth);
        // Printing the custom date
        System.out.println("Custom Date: " + customDate);
    }
}

Output:

Custom Date: 2024-03-22

Java LocalDate Example

Program to demonstrate methods of LocalDate class such as now(), minusDays(), plusDays().

LocalDateExample1.java

import java.time.LocalDate;  
public class LocalDateExample1 {  
  public static void main(String[] args) {  
    LocalDate date = LocalDate.now();  
    LocalDate yesterday = date.minusDays(1);  
    LocalDate tomorrow = yesterday.plusDays(2);  
    System.out.println("Today date: "+date);  
    System.out.println("Yesterday date: "+yesterday);  
    System.out.println("Tomorrow date: "+tomorrow);  
  }  
}  

Output:

Today date: 2017-01-13
Yesterday date: 2017-01-12
Tomorrow date: 2017-01-14

Program to demonstrate isLeapYear() method of LocalDate Class.

LocalDateExample2.java

import java.time.LocalDate;  
public class LocalDateExample2 {  
  public static void main(String[] args) {  
    LocalDate date1 = LocalDate.of(2017, 1, 13);  
    System.out.println(date1.isLeapYear());  
    LocalDate date2 = LocalDate.of(2016, 9, 23);  
    System.out.println(date2.isLeapYear());  
  }  
}  

Output:

false
true

Program to demonstrate atTime() method of LocalDate class.

LocalDateExample3.java

import java.time.*;
public class LocalDateExample3 {
  public static void main(String[] args) {
    LocalDate date = LocalDate.of(2017, 1, 13);
    LocalDateTime datetime = date.atTime(1,50,9);    
    System.out.println(datetime); 
  }
}

Output:

2017-01-13T01:50:09

Program to demonstrate format() method of LocalDate class

LocalDateExample4.java

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
public class LocalDateExample4
{
	public static void main(String ar[])
	{
		// Converting LocalDate to String
		// Example 1
		LocalDate d1 = LocalDate.now();
		String d1Str = d1.format(DateTimeFormatter.ISO_DATE);
		System.out.println("Date1 in string :  " + d1Str);
		// Example 2
		LocalDate d2 = LocalDate.of(2002, 05, 01);
		String d2Str = d2.format(DateTimeFormatter.ISO_DATE);
		System.out.println("Date2 in string :  " + d2Str);
		// Example 3
		LocalDate d3 = LocalDate.of(2016, 11, 01);
		String d3Str = d3.format(DateTimeFormatter.ISO_DATE);
		System.out.println("Date3 in string :  " + d3Str);
	}
}

Output:

Date1 in string :  2021-09-13
Date2 in string :  2002-05-01
Date3 in string :  2016-11-01

Program to demonstrate parse() method of LocalDate class

LocalDateExample5.java

import java.time.LocalDate;
// String to LocalDate in java 8
public class LocalDateExample5 
{
	public static void main(String ar[]) 
	{
		// Example 1
		String dInStr = "2011-09-01";
		LocalDate d1 = LocalDate.parse(dInStr);
		System.out.println("String to LocalDate : " + d1);
		// Example 2
		String dInStr2 = "2015-11-20";
		LocalDate d2 = LocalDate.parse(dInStr2);
		System.out.println("String to LocalDate : " + d2);
	}
}

Output:

String to LocalDate : 2011-09-01
String to LocalDate : 2015-11-20

Next TopicJava LocalTime

← prev next →

We provides tutorials and interview questions of all technology like java tutorial, android, java frameworks

Contact info

G-13, 2nd Floor, Sec-3, Noida, UP, 201301, India

[email protected].

Java LocalDate class