The maximum supported LocalDate
, '+999999999-12-31'.
The maximum supported LocalDate
, '+999999999-12-31'.
This could be used by an application as a "far future" date.
The minimum supported LocalDate
, '-999999999-01-01'.
The minimum supported LocalDate
, '-999999999-01-01'.
This could be used by an application as a "far past" date.
Obtains an instance of LocalDate
from a temporal object.
Obtains an instance of LocalDate
from a temporal object.
A TemporalAccessor
represents some form of date and time information.
This factory converts the arbitrary temporal object to an instance of LocalDate
.
The conversion uses the TemporalQueries#localDate()
query, which relies
on extracting the EPOCH_DAY
field.
This method matches the signature of the functional interface TemporalQuery
allowing it to be used as a query via method reference, LocalDate::from
.
the temporal object to convert, not null
the local date, not null
DateTimeException
if unable to convert to a { @code LocalDate}
Obtains the current date from the specified clock.
Obtains the current date from the specified clock.
This will query the specified clock to obtain the current date - today.
Using this method allows the use of an alternate clock for testing.
The alternate clock may be introduced using dependency injection
.
the clock to use, not null
the current date, not null
Obtains the current date from the system clock in the specified time-zone.
Obtains the current date from the system clock in the specified time-zone.
This will query the system clock
to obtain the current date.
Specifying the time-zone avoids dependence on the default time-zone.
Using this method will prevent the ability to use an alternate clock for testing because the clock is hard-coded.
the zone ID to use, not null
the current date using the system clock, not null
Obtains the current date from the system clock in the default time-zone.
Obtains the current date from the system clock in the default time-zone.
This will query the system clock
in the default
time-zone to obtain the current date.
Using this method will prevent the ability to use an alternate clock for testing because the clock is hard-coded.
the current date using the system clock and default time-zone, not null
Obtains an instance of LocalDate
from a year, month and day.
Obtains an instance of LocalDate
from a year, month and day.
The day must be valid for the year and month, otherwise an exception will be thrown.
the year to represent, from MIN_YEAR to MAX_YEAR
the month-of-year to represent, from 1 (January) to 12 (December)
the day-of-month to represent, from 1 to 31
the local date, not null
DateTimeException
if the day-of-month is invalid for the month-year
Obtains an instance of LocalDate
from a year, month and day.
Obtains an instance of LocalDate
from a year, month and day.
The day must be valid for the year and month, otherwise an exception will be thrown.
the year to represent, from MIN_YEAR to MAX_YEAR
the month-of-year to represent, not null
the day-of-month to represent, from 1 to 31
the local date, not null
DateTimeException
if the day-of-month is invalid for the month-year
Obtains an instance of LocalDate
from the epoch day count.
Obtains an instance of LocalDate
from the epoch day count.
The Epoch Day count is a simple incrementing count of days where day 0 is 1970-01-01. Negative numbers represent earlier days.
the Epoch Day to convert, based on the epoch 1970-01-01
the local date, not null
DateTimeException
if the epoch days exceeds the supported date range
Obtains an instance of LocalDate
from a year and day-of-year.
Obtains an instance of LocalDate
from a year and day-of-year.
The day-of-year must be valid for the year, otherwise an exception will be thrown.
the year to represent, from MIN_YEAR to MAX_YEAR
the day-of-year to represent, from 1 to 366
the local date, not null
DateTimeException
if the day-of-year is invalid for the month-year
Obtains an instance of LocalDate
from a text string using a specific formatter.
Obtains an instance of LocalDate
from a text string using a specific formatter.
The text is parsed using the formatter, returning a date.
the text to parse, not null
the formatter to use, not null
the parsed local date, not null
DateTimeParseException
if the text cannot be parsed
Obtains an instance of LocalDate
from a text string such as 2007-12-03
.
Obtains an instance of LocalDate
from a text string such as 2007-12-03
.
The string must represent a valid date and is parsed using
org.threeten.bp.format.DateTimeFormatter#ISO_LOCAL_DATE
.
the text to parse such as "2007-12-03", not null
the parsed local date, not null
DateTimeParseException
if the text cannot be parsed