Client and backend. This class is shared: the same code is compiled into your app and into your server, so everything on this page works in both.

public final class LocalDate

Object
LocalDate

ImplementsChronoLocalDate, Comparable<ChronoLocalDate>, Temporal, TemporalAccessor

A date of the ISO calendar with no time and no zone, such as 2007-12-03.

Fields

`public static final` `LocalDate MIN`	-999999999-01-01, the earliest date.
`public static final` `LocalDate MAX`	+999999999-12-31, the latest date.
`public static final` `LocalDate EPOCH`	1970-01-01.

Methods

`public static` `LocalDate now()`
`public static` `LocalDate now(ZoneId zone)`	The date today in `zone`.
`public static` `LocalDate now(Clock clock)`
`public static` `LocalDate of(int year, int month, int dayOfMonth)`
`public static` `LocalDate of(int year, Month month, int dayOfMonth)`
`public static` `LocalDate ofYearDay(int year, int dayOfYear)`	The `dayOfYear`th day of `year`.
`public static` `LocalDate ofInstant(Instant instant, ZoneId zone)`	The date `instant` falls on in `zone`.
`public static` `LocalDate ofEpochDay(long epochDay)`
`public static` `LocalDate from(TemporalAccessor temporal)`	The date of `temporal`.
`public static` `LocalDate parse(CharSequence text)`
`public static` `LocalDate parse(CharSequence text, DateTimeFormatter formatter)`
`public int getYear()`
`public int getMonthValue()`
`public` `Month getMonth()`	The month as a `Month`.
`public int getDayOfMonth()`
`public int getDayOfYear()`	The day of the year, 1 for January 1st.
`public` `DayOfWeek getDayOfWeek()`	The day of the week.
`public boolean isLeapYear()`	Whether the year of this date is a leap year.
`public int lengthOfMonth()`	The days in the month of this date.
`public int lengthOfYear()`	The days in the year of this date.
`public long toEpochDay()`	The days since 1970-01-01.
`public` `LocalDate withYear(int year)`
`public` `LocalDate withMonth(int month)`
`public` `LocalDate withDayOfMonth(int dayOfMonth)`
`public` `LocalDate withDayOfYear(int dayOfYear)`
`public boolean isSupported(TemporalUnit unit)`	Whether this value can add or subtract `unit`.
`public` `LocalDate plus(long amountToAdd, TemporalUnit unit)`	This value moved forward by `amountToAdd` of `unit`.
`public` `LocalDate minus(long amountToSubtract, TemporalUnit unit)`	This value moved back by `amountToSubtract` of `unit`.
`public` `LocalDate plus(TemporalAmount amount)`	This value moved forward by `amount`.
`public` `LocalDate minus(TemporalAmount amount)`	This value moved back by `amount`.
`public` `LocalDate plusDays(long daysToAdd)`
`public` `LocalDate plusWeeks(long weeksToAdd)`
`public` `LocalDate plusMonths(long monthsToAdd)`
`public` `LocalDate plusYears(long yearsToAdd)`
`public` `LocalDate minusDays(long daysToSubtract)`
`public` `LocalDate minusWeeks(long weeksToSubtract)`
`public` `LocalDate minusMonths(long monthsToSubtract)`
`public` `LocalDate minusYears(long yearsToSubtract)`
`public long until(Temporal endExclusive, TemporalUnit unit)`	The whole units of `unit` from this date to the date of `endExclusive`.
`public` `Period until(ChronoLocalDate endDateExclusive)`	The years, months and days from this date to `endDateExclusive`.
`public` `Stream<LocalDate> datesUntil(LocalDate endExclusive)`	The dates from this one up to and not including `endExclusive`, a day apart.
`public` `LocalDateTime atTime(int hour, int minute)`
`public` `LocalDateTime atTime(int hour, int minute, int second)`
`public` `LocalDateTime atTime(int hour, int minute, int second, int nano)`
`public` `LocalDateTime atTime(LocalTime time)`
`public` `LocalDateTime atStartOfDay()`	Midnight at the start of this date.
`public` `ZonedDateTime atStartOfDay(ZoneId zone)`
`public` `String format(DateTimeFormatter formatter)`
`public int compareTo(ChronoLocalDate other)`	Compares this object to the specified object to determine their relative order.
`public boolean isAfter(ChronoLocalDate other)`	Whether this date comes after `other`.
`public boolean isBefore(ChronoLocalDate other)`	Whether this date comes before `other`.
`public boolean isEqual(ChronoLocalDate other)`	Whether this date is the same day as `other`.
`public boolean equals(Object obj)`	Indicates whether some other object is “equal to” this one.
`public int hashCode()`	Returns a hash code value for the object.
`public` `String toString()`	The JDK’s text, `uuuu-MM-dd`, with a sign on a year past 9999.

Inherited methods

From Object

getClass, notify, notifyAll, wait, wait, wait, clone, finalize

Field details

MIN

public static final LocalDate MIN

-999999999-01-01, the earliest date.

MAX

public static final LocalDate MAX

+999999999-12-31, the latest date.

EPOCH

public static final LocalDate EPOCH

1970-01-01.

Method details

now

public static LocalDate now()

now

public static LocalDate now(ZoneId zone)

The date today in zone.

now

public static LocalDate now(Clock clock)

of

public static LocalDate of(int year, int month, int dayOfMonth)

of

public static LocalDate of(int year, Month month, int dayOfMonth)

ofYearDay

public static LocalDate ofYearDay(int year, int dayOfYear)

The dayOfYearth day of year.

ofInstant

public static LocalDate ofInstant(Instant instant, ZoneId zone)

The date instant falls on in zone.

ofEpochDay

public static LocalDate ofEpochDay(long epochDay)

from

public static LocalDate from(TemporalAccessor temporal)

The date of temporal.

parse

public static LocalDate parse(CharSequence text)

parse

public static LocalDate parse(CharSequence text, DateTimeFormatter formatter)

getYear

public int getYear()

getMonthValue

public int getMonthValue()

getMonth

public Month getMonth()

The month as a Month.

getDayOfMonth

public int getDayOfMonth()

getDayOfYear

public int getDayOfYear()

The day of the year, 1 for January 1st.

getDayOfWeek

public DayOfWeek getDayOfWeek()

The day of the week.

isLeapYear

public boolean isLeapYear()

Whether the year of this date is a leap year.

lengthOfMonth

public int lengthOfMonth()

The days in the month of this date.

lengthOfYear

public int lengthOfYear()

The days in the year of this date.

toEpochDay

public long toEpochDay()

The days since 1970-01-01.

withYear

public LocalDate withYear(int year)

withMonth

public LocalDate withMonth(int month)

withDayOfMonth

public LocalDate withDayOfMonth(int dayOfMonth)

withDayOfYear

public LocalDate withDayOfYear(int dayOfYear)

isSupported

public boolean isSupported(TemporalUnit unit)

Whether this value can add or subtract unit.

plus

public LocalDate plus(long amountToAdd, TemporalUnit unit)

This value moved forward by amountToAdd of unit.

minus

public LocalDate minus(long amountToSubtract, TemporalUnit unit)

This value moved back by amountToSubtract of unit.

plus

public LocalDate plus(TemporalAmount amount)

This value moved forward by amount.

minus

public LocalDate minus(TemporalAmount amount)

This value moved back by amount.

plusDays

public LocalDate plusDays(long daysToAdd)

plusWeeks

public LocalDate plusWeeks(long weeksToAdd)

plusMonths

public LocalDate plusMonths(long monthsToAdd)

plusYears

public LocalDate plusYears(long yearsToAdd)

minusDays

public LocalDate minusDays(long daysToSubtract)

minusWeeks

public LocalDate minusWeeks(long weeksToSubtract)

minusMonths

public LocalDate minusMonths(long monthsToSubtract)

minusYears

public LocalDate minusYears(long yearsToSubtract)

until

public long until(Temporal endExclusive, TemporalUnit unit)

The whole units of unit from this date to the date of endExclusive.

until

public Period until(ChronoLocalDate endDateExclusive)

The years, months and days from this date to endDateExclusive.

datesUntil

public Stream<LocalDate> datesUntil(LocalDate endExclusive)

The dates from this one up to and not including endExclusive, a day apart.

atTime

public LocalDateTime atTime(int hour, int minute)

atTime

public LocalDateTime atTime(int hour, int minute, int second)

atTime

public LocalDateTime atTime(int hour, int minute, int second, int nano)

atTime

public LocalDateTime atTime(LocalTime time)

atStartOfDay

public LocalDateTime atStartOfDay()

Midnight at the start of this date.

atStartOfDay

public ZonedDateTime atStartOfDay(ZoneId zone)

format

public String format(DateTimeFormatter formatter)

compareTo

public int compareTo(ChronoLocalDate other)

Compares this object to the specified object to determine their relative order.

Parameters

other ChronoLocalDate: the object to compare to this instance.

Returns

a negative integer if this instance is less than another; a positive integer if this instance is greater than another; 0 if this instance has the same order as another.

Throws

ClassCastException: if another cannot be converted into something comparable to this instance.

isAfter

public boolean isAfter(ChronoLocalDate other)

Whether this date comes after other.

isBefore

public boolean isBefore(ChronoLocalDate other)

Whether this date comes before other.

isEqual

public boolean isEqual(ChronoLocalDate other)

Whether this date is the same day as other.

equals

public boolean equals(Object obj)

Indicates whether some other object is “equal to” this one. The equals method implements an equivalence relation: It is reflexive: for any reference value x, x.equals(x) should return true. It is symmetric: for any reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true. It is transitive: for any reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true. It is consistent: for any reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the object is modified. For any non-null reference value x, x.equals(null) should return false. The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any reference values x and y, this method returns true if and only if x and y refer to the same object (x==y has the value true).

hashCode

public int hashCode()

Returns a hash code value for the object. This method is supported for the benefit of hashtables such as those provided by java.util.Hashtable. The general contract of hashCode is: Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hashtables. As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the JavaTM programming language.)

toString

public String toString()

The JDK’s text, uuuu-MM-dd, with a sign on a year past 9999.