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 ChronoField#EPOCH_DAY 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
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 Clock 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 Clock#system(ZoneId) 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 Clock#systemDefaultZone() 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
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
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
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
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
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
if the text cannot be parsed