Java LocalDate class

Java LocalDate class is an immutable class that represents Date with a default format of yyyy-mm-dd. It inherits 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.

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 →

Latest Courses

Javatpoint 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].

Frontend

Data Analytics

Database

Online Compiler

Backend

Technical Interview

Java Interview

Web Interview

Database Interview

Company Interviews

Java 8 Date Time

Java Date (Classical)

Java Date Format

Current Date Time

Java LocalDate class