Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class LocalDate extends Object implements Temporal, TemporalAdjuster, ChronoLocalDate<LocalDate>, Serializable
2007-12-03
.
LocalDate
неизменный разовый датой объект, который представляет дату, часто просматриваемую как "день месяца года". К другим полям даты, таким как день-летнего, день-недельного и неделя-летнего, можно также получить доступ. Например, значение "2-ого октября 2007" может быть сохранено в a LocalDate
.
Этот class не хранит или представляет время или часовой пояс. Вместо этого это - описание даты, как использующийся на дни рождения. Это не может представить момент на временной шкале без дополнительной информации, такой как смещение или часовой пояс.
Календарная система ISO 8601 является современной гражданской календарной системой, используемой сегодня в большей части мира. Это эквивалентно преждевременной системе Григорианского календаря, в которой сегодняшние правила в течение многих високосных годов применяются навсегда. Для большинства приложений, записанных сегодня, правила ISO 8601 являются полностью подходящими. Однако, любое приложение, которое использует исторические даты, и требует, чтобы они были точны, сочтет подход ISO 8601 неподходящим.
Модификатор и Тип | Поле и Описание |
---|---|
static LocalDate |
МАКСИМАЛЬНЫЙ
Максимум поддерживается
LocalDate , '+999999999-12-31'. |
static LocalDate |
МИН
Минимум поддерживается
LocalDate , '-999999999-01-01'. |
Модификатор и Тип | Метод и Описание |
---|---|
Временный |
adjustInto(Temporal temporal)
Корректирует указанный временный объект иметь ту же самую дату как этот объект.
|
LocalDateTime |
atStartOfDay()
Комбинирует эту дату со временем полуночи, чтобы создать a
LocalDateTime в начале этой даты. |
ZonedDateTime |
atStartOfDay(ZoneId zone)
Возвращает зонное разовое датой из этой даты в самое раннее допустимое время согласно правилам в часовом поясе.
|
LocalDateTime |
atTime(int hour, int minute)
Комбинирует эту дату со временем, чтобы создать a
LocalDateTime . |
LocalDateTime |
atTime(int hour, int minute, int second)
Комбинирует эту дату со временем, чтобы создать a
LocalDateTime . |
LocalDateTime |
atTime(int hour, int minute, int second, int nanoOfSecond)
Комбинирует эту дату со временем, чтобы создать a
LocalDateTime . |
LocalDateTime |
atTime(LocalTime time)
Комбинирует эту дату со временем, чтобы создать a
LocalDateTime . |
OffsetDateTime |
atTime(OffsetTime time)
Комбинирует эту дату со временем смещения, чтобы создать
OffsetDateTime . |
int |
compareTo(ChronoLocalDate<?> other)
Сравнивает эту дату с другой датой.
|
boolean |
equals(Object obj)
Проверки, если эта дата равна другой дате.
|
Строка |
format(DateTimeFormatter formatter)
Форматы эта дата, используя указанное средство форматирования.
|
static LocalDate |
from(TemporalAccessor temporal)
Получает экземпляр
LocalDate от временного объекта. |
int |
get(TemporalField field)
Получает значение указанного поля с этой даты как
int . |
IsoChronology |
getChronology()
Получает хронологию этой даты, которая является календарной системой ISO.
|
int |
getDayOfMonth()
Получает дневное-месячного поле.
|
DayOfWeek |
getDayOfWeek()
Получает дневное-недельного поле, которое является перечислением
DayOfWeek . |
int |
getDayOfYear()
Получает дневное-летнего поле.
|
Эра |
getEra()
Получает эру, применимую в этой дате.
|
long |
getLong(TemporalField field)
Получает значение указанного поля с этой даты как a
long . |
Месяц |
getMonth()
Получает поле месяца-летнего, используя
Month перечисление. |
int |
getMonthValue()
Получает поле месяца-летнего от 1 до 12.
|
int |
getYear()
Получает поле года.
|
int |
hashCode()
Хэш-код для этой даты.
|
boolean |
isAfter(ChronoLocalDate<?> other)
Проверки, если эта дата после указанной даты.
|
boolean |
isBefore(ChronoLocalDate<?> other)
Проверки, если эта дата перед указанной датой.
|
boolean |
isEqual(ChronoLocalDate<?> other)
Проверки, если эта дата равна указанной дате.
|
boolean |
isLeapYear()
Проверки, если год является високосным годом согласно ISO преждевременные календарные системные правила.
|
boolean |
isSupported(TemporalField field)
Проверки, если указанное поле поддерживается.
|
int |
lengthOfMonth()
Возвращает продолжительность месяца, представленного этой датой.
|
int |
lengthOfYear()
Возвращает продолжительность года, представленного этой датой.
|
LocalDate |
minus(long amountToSubtract, TemporalUnit unit)
Возвращает копию этой даты с указанным вычтенным количеством.
|
LocalDate |
minus(TemporalAmount amountToSubtract)
Возвращает копию этой даты с указанным вычтенным количеством.
|
LocalDate |
minusDays(long daysToSubtract)
Возвращает копию этого
LocalDate с конкретным количеством вычтенных дней. |
LocalDate |
minusMonths(long monthsToSubtract)
Возвращает копию этого
LocalDate с установленным периодом в вычтенных месяцах. |
LocalDate |
minusWeeks(long weeksToSubtract)
Возвращает копию этого
LocalDate с установленным периодом в вычтенных неделях. |
LocalDate |
minusYears(long yearsToSubtract)
Возвращает копию этого
LocalDate с установленным периодом в вычтенных годах. |
static LocalDate |
now()
Получает текущую дату из системных часов в часовом поясе значения по умолчанию.
|
static LocalDate |
now(Clock clock)
Получает текущую дату из указанных часов.
|
static LocalDate |
now(ZoneId zone)
Получает текущую дату из системных часов в указанном часовом поясе.
|
static LocalDate |
of(int year, int month, int dayOfMonth)
Получает экземпляр
LocalDate с года, месяца и дня. |
static LocalDate |
of(int year, Month month, int dayOfMonth)
Получает экземпляр
LocalDate с года, месяца и дня. |
static LocalDate |
ofEpochDay(long epochDay)
Получает экземпляр
LocalDate от дневного количества эпохи. |
static LocalDate |
ofYearDay(int year, int dayOfYear)
Получает экземпляр
LocalDate с года и дня-летнего. |
static LocalDate |
parse(CharSequence text)
Получает экземпляр
LocalDate от текстовой строки такой как 2007-12-03 . |
static LocalDate |
parse(CharSequence text, DateTimeFormatter formatter)
Получает экземпляр
LocalDate от текстовой строки, используя определенное средство форматирования. |
Период |
periodUntil(ChronoLocalDate<?> endDate)
Вычисляет период между этой датой и другой датой как a
Period . |
long |
periodUntil(Temporal endDate, TemporalUnit unit)
Вычисляет количество времени до другой даты с точки зрения указанного модуля.
|
LocalDate |
plus(long amountToAdd, TemporalUnit unit)
Возвращает копию этой даты с указанным добавленным количеством.
|
LocalDate |
plus(TemporalAmount amountToAdd)
Возвращает копию этой даты с указанным добавленным количеством.
|
LocalDate |
plusDays(long daysToAdd)
Возвращает копию этого
LocalDate с конкретным количеством добавленных дней. |
LocalDate |
plusMonths(long monthsToAdd)
Возвращает копию этого
LocalDate с установленным периодом в добавленных месяцах. |
LocalDate |
plusWeeks(long weeksToAdd)
Возвращает копию этого
LocalDate с установленным периодом в добавленных неделях. |
LocalDate |
plusYears(long yearsToAdd)
Возвращает копию этого
LocalDate с установленным периодом в добавленных годах. |
<R> R |
query(TemporalQuery<R> query)
Запросы эта дата, используя указанный запрос.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
long |
toEpochDay()
Преобразовывает эту дату в День Эпохи.
|
Строка |
toString()
Выводит эту дату как a
String , такой как 2007-12-03 . |
LocalDate |
with(TemporalAdjuster adjuster)
Возвращает скорректированную копию этой даты.
|
LocalDate |
with(TemporalField field, long newValue)
Возвращает копию этой даты с указанным полевым набором к новому значению.
|
LocalDate |
withDayOfMonth(int dayOfMonth)
Возвращает копию этой даты с измененным днем-месячного.
|
LocalDate |
withDayOfYear(int dayOfYear)
Возвращает копию этой даты с измененным днем-летнего.
|
LocalDate |
withMonth(int month)
Возвращает копию этой даты с измененным месяцем-летнего.
|
LocalDate |
withYear(int year)
Возвращает копию этой даты с измененным годом.
|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
timeLineOrder
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame
public static final LocalDate MIN
LocalDate
, '-999999999-01-01'. Это могло использоваться приложением в качестве "далекой прошлой" даты.public static final LocalDate MAX
LocalDate
, '+999999999-12-31'. Это могло использоваться приложением в качестве "далекой будущей" даты.public static LocalDate now()
Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить текущую дату.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
public static LocalDate now(ZoneId zone)
Это запросит system clock
получить текущую дату. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
zone
- зональный ID, чтобы использовать, не нульpublic static LocalDate now(Clock clock)
Это запросит указанные часы, чтобы получить текущую дату - сегодня. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection
.
clock
- часы, чтобы использовать, не нульpublic static LocalDate of(int year, Month month, int dayOfMonth)
LocalDate
с года, месяца и дня. Это возвращает a LocalDate
с указанным годом, месяцем и днем-месячного. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано.
year
- год, чтобы представить, от MIN_YEAR до MAX_YEARmonth
- месяц-летнего, чтобы представить, не нульdayOfMonth
- день-месячного, чтобы представить, от 1 до 31DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static LocalDate of(int year, int month, int dayOfMonth)
LocalDate
с года, месяца и дня. Это возвращает a LocalDate
с указанным годом, месяцем и днем-месячного. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано.
year
- год, чтобы представить, от MIN_YEAR до MAX_YEARmonth
- месяц-летнего, чтобы представить, от 1 (январь) к 12 (декабрь)dayOfMonth
- день-месячного, чтобы представить, от 1 до 31DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static LocalDate ofYearDay(int year, int dayOfYear)
LocalDate
с года и дня-летнего. Это возвращает a LocalDate
с указанным годом и днем-летнего. День-летнего должен быть допустимым в течение года, иначе исключение будет выдано.
year
- год, чтобы представить, от MIN_YEAR до MAX_YEARdayOfYear
- день-летнего, чтобы представить, от 1 до 366DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-летнего недопустим для летнего месяцемpublic static LocalDate ofEpochDay(long epochDay)
LocalDate
от дневного количества эпохи. Это возвращает a LocalDate
с указанным дневным эпохой. EPOCH_DAY
простое количество постепенного увеличения дней, где день 0 01.01.1970. Отрицательные числа представляют более ранние дни.
epochDay
- День Эпохи, чтобы преобразовать, основанный на эпохе 01.01.1970DateTimeException
- если дни эпохи превышают поддерживаемый диапазон датpublic static LocalDate from(TemporalAccessor temporal)
LocalDate
от временного объекта. Это получает локальную дату, основанную на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр LocalDate
.
Преобразование использует TemporalQuery.localDate()
запрос, который полагается на извлечение EPOCH_DAY
поле.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, LocalDate::from
.
from
в интерфейсе ChronoLocalDate<LocalDate>
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a LocalDate
Chronology.date(TemporalAccessor)
public static LocalDate parse(CharSequence text)
LocalDate
от текстовой строки такой как 2007-12-03
. Строка должна представить допустимую дату и анализируется, используя DateTimeFormatter.ISO_LOCAL_DATE
.
text
- текст, чтобы проанализировать такой как "2007-12-03", не нульDateTimeParseException
- если текст не может быть проанализированpublic static LocalDate parse(CharSequence text, DateTimeFormatter formatter)
LocalDate
от текстовой строки, используя определенное средство форматирования. Текст анализируется, используя средство форматирования, возвращая дату.
text
- текст, чтобы проанализировать, не нульformatter
- средство форматирования, чтобы использовать, не нульDateTimeParseException
- если текст не может быть проанализированpublic boolean isSupported(TemporalField field)
Это проверяет, может ли эта дата быть запрошена для указанного поля. Если ложь, то вызов range
и get
методы выдадут исключение.
Если поле является a ChronoField
тогда запрос реализуется здесь. Поддерживаемые поля:
DAY_OF_WEEK
ALIGNED_DAY_OF_WEEK_IN_MONTH
ALIGNED_DAY_OF_WEEK_IN_YEAR
DAY_OF_MONTH
DAY_OF_YEAR
EPOCH_DAY
ALIGNED_WEEK_OF_MONTH
ALIGNED_WEEK_OF_YEAR
MONTH_OF_YEAR
PROLEPTIC_MONTH
YEAR_OF_ERA
YEAR
ERA
ChronoField
экземпляры возвратят false. Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.isSupportedBy(TemporalAccessor)
передача this
как параметр. Поддерживается ли поле, определяется полем.
isSupported
в интерфейсе ChronoLocalDate<LocalDate>
isSupported
в интерфейсе TemporalAccessor
field
- поле, чтобы проверить, обнулите, возвращает falsepublic ValueRange range(TemporalField field)
Объект диапазона выражает минимальные и максимальные допустимые значения для поля. Эта дата используется, чтобы улучшить точность возвращенного диапазона. Если не возможно возвратить диапазон, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField
тогда запрос реализуется здесь. supported fields
возвратит соответствующие экземпляры диапазона. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.rangeRefinedBy(TemporalAccessor)
передача this
как параметр. Может ли диапазон быть получен, определяется полем.
range
в интерфейсе TemporalAccessor
field
- поле, чтобы запросить диапазон для, не нульDateTimeException
- если диапазон для поля не может быть полученUnsupportedTemporalTypeException
- если поле не поддерживаетсяpublic int get(TemporalField field)
int
. Это запрашивает эту дату значения для указанного поля. Возвращенное значение всегда будет в пределах допустимого диапазона значений для поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField
тогда запрос реализуется здесь. supported fields
возвратит допустимые значения, основанные на этой дате, кроме EPOCH_DAY
и PROLEPTIC_MONTH
которые являются слишком большими, чтобы вписаться int
и бросок a DateTimeException
. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor)
передача this
как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
get
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульDateTimeException
- если значение для поля не может быть получено, или значение вне диапазона допустимых значений для поляUnsupportedTemporalTypeException
- если поле не поддерживается, или диапазон значений превышает int
ArithmeticException
- если числовое переполнение происходитpublic long getLong(TemporalField field)
long
. Это запрашивает эту дату значения для указанного поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField
тогда запрос реализуется здесь. supported fields
возвратит допустимые значения, основанные на этой дате. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor)
передача this
как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
getLong
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульDateTimeException
- если значение для поля не может быть полученоUnsupportedTemporalTypeException
- если поле не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic IsoChronology getChronology()
Chronology
представляет календарную систему в использовании. Календарная система ISO 8601 является современной гражданской календарной системой, используемой сегодня в большей части мира. Это эквивалентно преждевременной системе Григорианского календаря, в которой сегодняшние правила в течение многих високосных годов применяются навсегда.
getChronology
в интерфейсе ChronoLocalDate<LocalDate>
public Era getEra()
Официальный стандарт ISO 8601 не определяет эры, однако IsoChronology
делает. Это определяет две эры, 'CE' с года один вперед и 'BCE' от нуля года назад. Начиная с дат прежде, чем Юлианско-грегорианские cutover не соответствуют истории, cutover между 'BCE' и 'CE' также не выравнивается с обычно используемыми эрами, часто упоминал использование 'BC' и 'AD'.
Пользователи этого class должны обычно игнорировать этот метод, поскольку это существует прежде всего, чтобы выполнить ChronoLocalDate
заключите контракт, где необходимо поддерживать японскую календарную систему.
Возвращенная эра будет одиночным элементом, способным к тому, чтобы быть по сравнению с константами в IsoChronology
использование ==
оператор.
getEra
в интерфейсе ChronoLocalDate<LocalDate>
IsoChronology
эра, постоянная применимый в этой дате, не нулеpublic int getYear()
Этот метод возвращает примитив int
значение в течение года.
Год, возвращенный этим методом, является преждевременным согласно get(YEAR)
. Чтобы получить год эры, использовать get(YEAR_OF_ERA)
.
public int getMonthValue()
Этот метод возвращает месяц как int
от 1 до 12. Код программы является часто более четким если перечисление Month
используется, вызывая getMonth()
.
getMonth()
public Month getMonth()
Month
перечисление. Этот метод возвращает перечисление Month
в течение месяца. Это избегает беспорядка относительно какой int
среднее значение значений. Если Вы нуждаетесь в доступе к примитиву int
значение тогда перечисление обеспечивает int value
.
getMonthValue()
public int getDayOfMonth()
Этот метод возвращает примитив int
значение в течение дня-месячного.
public int getDayOfYear()
Этот метод возвращает примитив int
значение в течение дня-летнего.
public DayOfWeek getDayOfWeek()
DayOfWeek
. Этот метод возвращает перечисление DayOfWeek
в течение дня-недельного. Это избегает беспорядка относительно какой int
среднее значение значений. Если Вы нуждаетесь в доступе к примитиву int
значение тогда перечисление обеспечивает int value
.
Дополнительная информация может быть получена из DayOfWeek
. Это включает текстовые имена значений.
public boolean isLeapYear()
Этот метод применяет текущие правила в течение многих високосных годов через целую временную шкалу. Вообще, год является високосным годом, если это является делимым четыре без остатка. Однако, годы, делимые 100, не високосные годы, за исключением лет, делимых 400, которые являются.
Например, 1904 является високосным годом, это является делимым 4. 1900 не был високосным годом, поскольку это является делимым 100, однако 2000 был високосным годом, поскольку это является делимым 400.
Вычисление является преждевременным - применение тех же самых правил в далекое будущее и далеко мимо. Это исторически неточно, но корректно для стандарта ISO 8601.
isLeapYear
в интерфейсе ChronoLocalDate<LocalDate>
public int lengthOfMonth()
Это возвращает продолжительность месяца в днях. Например, дата в январе возвратилась бы 31.
lengthOfMonth
в интерфейсе ChronoLocalDate<LocalDate>
public int lengthOfYear()
Это возвращает продолжительность года в днях, или 365 или 366.
lengthOfYear
в интерфейсе ChronoLocalDate<LocalDate>
public LocalDate with(TemporalAdjuster adjuster)
Это возвращает a LocalDate
, основанный на этом, со скорректированной датой. Корректировка имеет место, используя указанный объект стратегии регулятора. Считайте документацию регулятора, чтобы понять, какая корректировка будет внесена.
Простой регулятор мог бы просто установить то из полей, таких как поле года. Более сложный регулятор мог бы назначить дату к прошлому дню месяца. В выборе общих корректировок обеспечивают TemporalAdjuster
. Они включают обнаружение "в последний день месяца" и "следующей среды". Разовые основным сроком классы также реализуют TemporalAdjuster
интерфейс, такой как Month
и MonthDay
. Регулятор ответственен за обработку особых случаев, таких как переменные продолжительности месяца и високосных годов.
Например этот код возвращает дату в прошлый день июля:
import static java.time.Month.*; import static java.time.temporal.Adjusters.*; result = localDate.with(JULY).with(lastDayOfMonth());
Результат этого метода получается, вызывая TemporalAdjuster.adjustInto(Temporal)
метод на указанной передаче регулятора this
как параметр.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
with
в интерфейсе ChronoLocalDate<LocalDate>
with
в интерфейсе Temporal
adjuster
- регулятор, чтобы использовать, не нульLocalDate
основанный на this
с внесенной корректировкой, не нульDateTimeException
- если корректировка не может быть внесенаArithmeticException
- если числовое переполнение происходитpublic LocalDate with(TemporalField field, long newValue)
Это возвращает a LocalDate
, основанный на этом, со значением для указанного поля изменился. Это может использоваться, чтобы изменить любое поддерживаемое поле, такое как год, месяц или день-месячного. Если не возможно установить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
В некоторых случаях изменение указанного поля может заставить получающуюся дату становиться недопустимой, такие как изменение месяца с 31-ого января до февраля сделал бы день-месячного недопустимым. В случаях как это поле ответственно за разрешение даты. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
Если поле является a ChronoField
тогда корректировка реализуется здесь. Поддерживаемые поля ведут себя следующим образом:
DAY_OF_WEEK
- Возвраты a LocalDate
с указанным днем-недельного. Дата корректируется до 6 дней вперед или назад в пределах границы понедельника к воскресной неделе. ALIGNED_DAY_OF_WEEK_IN_MONTH
- Возвраты a LocalDate
с указанным "выровненным днем недели". Дата корректируется к указанному основанному на месяце "выровненному дню недели". Выровненные недели считаются так, что, первая неделя данного месяца запускается в первый день того месяца. Это может заставить дату быть перемещенной до 6 дней в следующий месяц. ALIGNED_DAY_OF_WEEK_IN_YEAR
- Возвраты a LocalDate
с указанным "выровненным днем недели". Дата корректируется к указанному основанному на годе "выровненному дню недели". Выровненные недели считаются так, что, первая неделя данного года запускается в первый день того года. Это может заставить дату быть перемещенной до 6 дней в следующий год. DAY_OF_MONTH
- Возвраты a LocalDate
с указанным днем-месячного. Месяц и год будут неизменны. Если день-месячного недопустим в течение года и месяца, то a DateTimeException
бросается. DAY_OF_YEAR
- Возвраты a LocalDate
с указанным днем-летнего. Год будет неизменен. Если день-летнего недопустим в течение года, то a DateTimeException
бросается. EPOCH_DAY
- Возвраты a LocalDate
с указанным дневным эпохой. Это полностью заменяет дату и эквивалентно ofEpochDay(long)
. ALIGNED_WEEK_OF_MONTH
- Возвраты a LocalDate
с указанной "выровненной неделей месяца". Выровненные недели считаются так, что, первая неделя данного месяца запускается в первый день того месяца. Эта корректировка перемещает дату в целые недельные блоки, чтобы соответствовать указанную неделю. У результата будет тот же самый день-недельного как эта дата. Это может заставить дату быть перемещенной в следующий месяц. ALIGNED_WEEK_OF_YEAR
- Возвраты a LocalDate
с указанной "выровненной неделей года". Выровненные недели считаются так, что, первая неделя данного года запускается в первый день того года. Эта корректировка перемещает дату в целые недельные блоки, чтобы соответствовать указанную неделю. У результата будет тот же самый день-недельного как эта дата. Это может заставить дату быть перемещенной в следующий год. MONTH_OF_YEAR
- Возвраты a LocalDate
с указанным месяцем-летнего. Год будет неизменен. День-месячного также будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. PROLEPTIC_MONTH
- Возвраты a LocalDate
с указанным преждевременно-месячным. День-месячного будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. YEAR_OF_ERA
- Возвраты a LocalDate
с указанным годом эры. Эра и месяц будут неизменны. День-месячного также будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. YEAR
- Возвраты a LocalDate
с указанным годом. Месяц будет неизменен. День-месячного также будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. ERA
- Возвраты a LocalDate
с указанной эрой. Год эры и месяц будут неизменны. День-месячного также будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. Во всех случаях, если новое значение вне допустимого диапазона значений для поля тогда a DateTimeException
будет брошен.
Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.adjustInto(Temporal, long)
передача this
как параметр. В этом случае поле определяет, ли и как скорректировать момент.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
with
в интерфейсе ChronoLocalDate<LocalDate>
with
в интерфейсе Temporal
field
- поле, чтобы установить в результате, не нулеnewValue
- новое значение поля в результатеLocalDate
основанный на this
с указанным полевым набором, не нулемDateTimeException
- если поле не может быть установленоUnsupportedTemporalTypeException
- если поле не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic LocalDate withYear(int year)
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
year
- год, чтобы установить в результате, от MIN_YEAR до MAX_YEARLocalDate
основанный на этой дате с требуемым годом, не нулеDateTimeException
- если значение года недопустимоpublic LocalDate withMonth(int month)
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
month
- месяц-летнего, чтобы установить в результате, от 1 (январь) к 12 (декабрь)LocalDate
основанный на этой дате с требуемым месяцем, не нулеDateTimeException
- если значение месяца-летнего недопустимоpublic LocalDate withDayOfMonth(int dayOfMonth)
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
dayOfMonth
- день-месячного, чтобы установить в результате, от 1 до 28-31LocalDate
основанный на этой дате с требуемым днем, не нулеDateTimeException
- если дневное-месячного значение недопустимо, или если день-месячного недопустим для летнего месяцемpublic LocalDate withDayOfYear(int dayOfYear)
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
dayOfYear
- день-летнего, чтобы установить в результате, от 1 до 365-366LocalDate
основанный на этой дате с требуемым днем, не нулеDateTimeException
- если дневное-летнего значение недопустимо, или если день-летнего недопустим в течение годаpublic LocalDate plus(TemporalAmount amountToAdd)
Это возвращает a LocalDate
, основанный на этом, с указанным добавленным количеством. Количество обычно Period
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс.
Вычисление делегируется к объекту количества, вызывая TemporalAmount.addTo(Temporal)
. Реализация количества свободна реализовать дополнение всегда, это желает, однако это обычно перезванивает к plus(long, TemporalUnit)
. Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно добавлено.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
plus
в интерфейсе ChronoLocalDate<LocalDate>
plus
в интерфейсе Temporal
amountToAdd
- количество, чтобы добавить, не нульLocalDate
основанный на этой дате со сделанным дополнением, не нульDateTimeException
- если дополнение не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic LocalDate plus(long amountToAdd, TemporalUnit unit)
Это возвращает a LocalDate
, основанный на этом, с количеством с точки зрения модуля добавил. Если не возможно добавить количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
В некоторых случаях добавление количества может заставить получающуюся дату становиться недопустимой. Например, добавление одного месяца до 31-ого января закончилось бы в 31-ое февраля. В случаях как это модуль ответственен за разрешение даты. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
Если поле является a ChronoUnit
тогда дополнение реализуется здесь. Поддерживаемые поля ведут себя следующим образом:
DAYS
- Возвраты a LocalDate
с конкретным количеством добавленных дней. Это эквивалентно plusDays(long)
. WEEKS
- Возвраты a LocalDate
с конкретным количеством добавленных недель. Это эквивалентно plusWeeks(long)
и использует 7-дневную неделю. MONTHS
- Возвраты a LocalDate
с конкретным количеством добавленных месяцев. Это эквивалентно plusMonths(long)
. День-месячного будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. YEARS
- Возвраты a LocalDate
с конкретным количеством добавленных лет. Это эквивалентно plusYears(long)
. День-месячного будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. DECADES
- Возвраты a LocalDate
с конкретным количеством добавленных десятилетий. Это эквивалентно вызову plusYears(long)
с количеством, умноженным на 10. День-месячного будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. CENTURIES
- Возвраты a LocalDate
с конкретным количеством добавленных столетий. Это эквивалентно вызову plusYears(long)
с количеством, умноженным на 100. День-месячного будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. MILLENNIA
- Возвраты a LocalDate
с конкретным количеством добавленных тысячелетий. Это эквивалентно вызову plusYears(long)
с количеством, умноженным на 1 000. День-месячного будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. ERAS
- Возвраты a LocalDate
с конкретным количеством добавленных эр. Только две эры поддерживаются так, количество должно быть один, нуль или минус один. Если количество является ненулевым тогда, год изменяется так, что, год эры неизменен. День-месячного будет неизменен, если это не было бы недопустимо в течение нового месяца и года. В этом случае день-месячного корректируется к максимальному допустимому значению в течение нового месяца и года. Все другой ChronoUnit
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoUnit
, тогда результат этого метода получается, вызывая TemporalUnit.addTo(Temporal, long)
передача this
как параметр. В этом случае модуль определяет, ли и как выполнить дополнение.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
plus
в интерфейсе ChronoLocalDate<LocalDate>
plus
в интерфейсе Temporal
amountToAdd
- количество модуля, чтобы добавить к результату, может быть отрицательнымunit
- модуль количества, чтобы добавить, не нульLocalDate
основанный на этой дате с указанным количеством добавил, не нульDateTimeException
- если дополнение не может быть сделаноUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic LocalDate plusYears(long yearsToAdd)
LocalDate
с установленным периодом в добавленных годах. Этот метод добавляет указанное количество к полю лет в трех шагах:
Например, 29.02.2008 (високосный год) плюс один год привел бы к недопустимой дате 29.02.2009 (стандартный год). Вместо того, чтобы возвратить недопустимый результат, прошлый допустимый день месяца, 28.02.2009, выбирается вместо этого.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
yearsToAdd
- годы, чтобы добавить, может быть отрицательнымLocalDate
основанный на этой дате с годами добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDate plusMonths(long monthsToAdd)
LocalDate
с установленным периодом в добавленных месяцах. Этот метод добавляет указанное количество к полю месяцев в трех шагах:
Например, 31.03.2007 плюс один месяц привел бы к недопустимой дате 31.04.2007. Вместо того, чтобы возвратить недопустимый результат, прошлый допустимый день месяца, 30.04.2007, выбирается вместо этого.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
monthsToAdd
- месяцы, чтобы добавить, может быть отрицательнымLocalDate
основанный на этой дате с месяцами добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDate plusWeeks(long weeksToAdd)
LocalDate
с установленным периодом в добавленных неделях. Этот метод добавляет указанное количество в неделях к дневному полю, постепенно увеличивающему поля месяца и года по мере необходимости, чтобы гарантировать, что результат остается допустимым. Результат только недопустим, если максимальный/минимальный год превышается.
Например, 31.12.2008 плюс одна неделя закончился бы в 07.01.2009.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
weeksToAdd
- недели, чтобы добавить, может быть отрицательнымLocalDate
основанный на этой дате с неделями добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDate plusDays(long daysToAdd)
LocalDate
с конкретным количеством добавленных дней. Этот метод добавляет указанное количество к дневному полю, постепенно увеличивающему поля месяца и года по мере необходимости, чтобы гарантировать, что результат остается допустимым. Результат только недопустим, если максимальный/минимальный год превышается.
Например, 31.12.2008 плюс один день закончился бы в 01.01.2009.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
daysToAdd
- дни, чтобы добавить, может быть отрицательнымLocalDate
основанный на этой дате со днями добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDate minus(TemporalAmount amountToSubtract)
Это возвращает a LocalDate
, основанный на этом, с указанным вычтенным количеством. Количество обычно Period
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс.
Вычисление делегируется к объекту количества, вызывая TemporalAmount.subtractFrom(Temporal)
. Реализация количества свободна реализовать вычитание всегда, это желает, однако это обычно перезванивает к minus(long, TemporalUnit)
. Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно вычтено.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minus
в интерфейсе ChronoLocalDate<LocalDate>
minus
в интерфейсе Temporal
amountToSubtract
- количество, чтобы вычесть, не нульLocalDate
основанный на этой дате со сделанным вычитанием, не нульDateTimeException
- если вычитание не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic LocalDate minus(long amountToSubtract, TemporalUnit unit)
Это возвращает a LocalDate
, основанный на этом, с количеством с точки зрения модуля вычитается. Если не возможно вычесть количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
Этот метод эквивалентен plus(long, TemporalUnit)
с отрицаемым количеством. См., что метод для полного описания того, как дополнение, и таким образом вычитание, работают.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minus
в интерфейсе ChronoLocalDate<LocalDate>
minus
в интерфейсе Temporal
amountToSubtract
- количество модуля, чтобы вычесть из результата, может быть отрицательнымunit
- модуль количества, чтобы вычесть, не нульLocalDate
основанный на этой дате с указанным вычтенным количеством, не нульDateTimeException
- если вычитание не может быть сделаноUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic LocalDate minusYears(long yearsToSubtract)
LocalDate
с установленным периодом в вычтенных годах. Этот метод вычитает указанное количество из поля лет в трех шагах:
Например, 29.02.2008 (високосный год) минус один год привел бы к недопустимой дате 29.02.2007 (стандартный год). Вместо того, чтобы возвратить недопустимый результат, прошлый допустимый день месяца, 28.02.2007, выбирается вместо этого.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
yearsToSubtract
- годы, чтобы вычесть, может быть отрицательнымLocalDate
основанный на этой дате с вычтенными годами, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDate minusMonths(long monthsToSubtract)
LocalDate
с установленным периодом в вычтенных месяцах. Этот метод вычитает указанное количество из поля месяцев в трех шагах:
Например, 31.03.2007 минус один месяц привел бы к недопустимой дате 31.02.2007. Вместо того, чтобы возвратить недопустимый результат, прошлый допустимый день месяца, 28.02.2007, выбирается вместо этого.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
monthsToSubtract
- месяцы, чтобы вычесть, может быть отрицательнымLocalDate
основанный на этой дате с вычтенными месяцами, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDate minusWeeks(long weeksToSubtract)
LocalDate
с установленным периодом в вычтенных неделях. Этот метод вычитает указанное количество в неделях от дневного поля, постепенно уменьшающего поля месяца и года по мере необходимости, чтобы гарантировать, что результат остается допустимым. Результат только недопустим, если максимальный/минимальный год превышается.
Например, 07.01.2009 минус одна неделя закончился бы в 31.12.2008.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
weeksToSubtract
- недели, чтобы вычесть, может быть отрицательнымLocalDate
основанный на этой дате с вычтенными неделями, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDate minusDays(long daysToSubtract)
LocalDate
с конкретным количеством вычтенных дней. Этот метод вычитает указанное количество из дневного поля, постепенно уменьшающего поля месяца и года по мере необходимости, чтобы гарантировать, что результат остается допустимым. Результат только недопустим, если максимальный/минимальный год превышается.
Например, 01.01.2009 минус один день закончился бы в 31.12.2008.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
daysToSubtract
- дни, чтобы вычесть, может быть отрицательнымLocalDate
основанный на этой дате с вычтенными днями, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic <R> R query(TemporalQuery<R> query)
Это запрашивает эту дату, используя указанный объект стратегии запроса. TemporalQuery
объект определяет логику, которая будет использоваться, чтобы получить результат. Считайте документацию запроса, чтобы понять, каков результат этого метода будет.
Результат этого метода получается, вызывая TemporalQuery.queryFrom(TemporalAccessor)
метод на указанной передаче запроса this
как параметр.
query
в интерфейсе ChronoLocalDate<LocalDate>
query
в интерфейсе TemporalAccessor
R
- тип результатаquery
- запрос, чтобы вызвать, не нульDateTimeException
- если неспособный запрашивать (определенный запросом)ArithmeticException
- если числовое переполнение происходит (определенный запросом)public Temporal adjustInto(Temporal temporal)
Это возвращает временный объект того же самого заметного типа как ввод с датой, измененной, чтобы быть тем же самым как этим.
Корректировка эквивалентна использованию Temporal.with(TemporalField, long)
передача ChronoField.EPOCH_DAY
как поле.
В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.with(TemporalAdjuster)
:
// these two lines are equivalent, but the second approach is recommended temporal = thisLocalDate.adjustInto(temporal); temporal = temporal.with(thisLocalDate);
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
adjustInto
в интерфейсе ChronoLocalDate<LocalDate>
adjustInto
в интерфейсе TemporalAdjuster
temporal
- целевой объект, который будет скорректирован, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитpublic long periodUntil(Temporal endDate, TemporalUnit unit)
Это вычисляет количество времени между два LocalDate
объекты с точки зрения сингла TemporalUnit
. Запуск и конечные точки this
и указанная дата. Результат будет отрицателен, если конец будет перед запуском. Temporal
переданный к этому методу должен быть a LocalDate
. Например, количество в днях между двумя датами может быть вычислено, используя startDate.periodUntil(endDate, DAYS)
.
Вычисление возвращает целое число, представляя число полных модулей между этими двумя датами. Например, количество в месяцах между 15.06.2012 и 14.08.2012 только будет одним месяцем, поскольку это - один день за исключением двух месяцев.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод. Второе должно использовать TemporalUnit.between(Temporal, Temporal)
:
// these two lines are equivalent amount = start.periodUntil(end, MONTHS); amount = MONTHS.between(start, end);Выбор должен быть сделан основанный, которого делает код более читаемым.
Вычисление реализуется в этом методе для ChronoUnit
. Модули DAYS
, WEEKS
, MONTHS
, YEARS
, DECADES
, CENTURIES
, MILLENNIA
и ERAS
поддерживаются. Другой ChronoUnit
значения выдадут исключение.
Если модуль не является a ChronoUnit
, тогда результат этого метода получается, вызывая TemporalUnit.between(Temporal, Temporal)
передача this
как первый параметр и ввод, временный как второй параметр.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
periodUntil
в интерфейсе ChronoLocalDate<LocalDate>
periodUntil
в интерфейсе Temporal
endDate
- дата окончания, которая должна быть a LocalDate
, не нульunit
- модуль, чтобы измерить количество в, не нульDateTimeException
- если количество не может быть вычисленоUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic Period periodUntil(ChronoLocalDate<?> endDate)
Period
. Это вычисляет период между двумя датами с точки зрения лет, месяцев и дней. Запуск и конечные точки this
и указанная дата. Результат будет отрицателен, если конец будет перед запуском. Знак минус будет тем же самым в каждом годе, месяце и дне.
Вычисление выполняется, используя календарную систему ISO. В случае необходимости входная дата будет преобразована в ISO.
Дата начала включается, но дата окончания не. Период вычисляется, удаляя полные месяцы, тогда вычисляя остающееся число дней, корректируясь, чтобы гарантировать, что у обоих есть тот же самый знак. Число месяцев тогда нормализуется в годы и месяцы, основанные на 12-месячном году. Месяц, как полагают, полон, если день-месячного конца больше чем или равен дню-месячного запуска. Например, от 2010-01-15
к 2011-03-18
"1 год, 2 месяца и 3 дня".
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод. Второе должно использовать Period.between(LocalDate, LocalDate)
:
// these two lines are equivalent period = start.periodUntil(end); period = Period.between(start, end);Выбор должен быть сделан основанный, которого делает код более читаемым.
periodUntil
в интерфейсе ChronoLocalDate<LocalDate>
endDate
- дата окончания, монопольная, который может быть в любой хронологии, не нулеpublic String format(DateTimeFormatter formatter)
Эту дату передадут к средству форматирования, чтобы произвести строку.
format
в интерфейсе ChronoLocalDate<LocalDate>
formatter
- средство форматирования, чтобы использовать, не нульDateTimeException
- если ошибка происходит во время печатиpublic LocalDateTime atTime(LocalTime time)
LocalDateTime
. Это возвращает a LocalDateTime
сформированный из этой даты в требуемое время. Все возможные комбинации даты и время допустимы.
atTime
в интерфейсе ChronoLocalDate<LocalDate>
time
- время, чтобы объединить с, не нульpublic LocalDateTime atTime(int hour, int minute)
LocalDateTime
. Это возвращает a LocalDateTime
сформированный из этой даты в указанный час и минуту. Секунды и поля наносекунды будут обнулены. Отдельные поля времени должны быть в пределах их допустимого диапазона. Все возможные комбинации даты и время допустимы.
hour
- час-дневного, чтобы использовать, от 0 до 23minute
- минута-часового, чтобы использовать, от 0 до 59DateTimeException
- если значение какого-либо поля испытывает недостаток диапазонаpublic LocalDateTime atTime(int hour, int minute, int second)
LocalDateTime
. Это возвращает a LocalDateTime
сформированный из этой даты в указанный час, минуту и второй. Поле наносекунды будет обнулено. Отдельные поля времени должны быть в пределах их допустимого диапазона. Все возможные комбинации даты и время допустимы.
hour
- час-дневного, чтобы использовать, от 0 до 23minute
- минута-часового, чтобы использовать, от 0 до 59second
- второе-минутного, чтобы представить, от 0 до 59DateTimeException
- если значение какого-либо поля испытывает недостаток диапазонаpublic LocalDateTime atTime(int hour, int minute, int second, int nanoOfSecond)
LocalDateTime
. Это возвращает a LocalDateTime
сформированный из этой даты в указанный час, минуту, вторую и наносекунда. Отдельные поля времени должны быть в пределах их допустимого диапазона. Все возможные комбинации даты и время допустимы.
hour
- час-дневного, чтобы использовать, от 0 до 23minute
- минута-часового, чтобы использовать, от 0 до 59second
- второе-минутного, чтобы представить, от 0 до 59nanoOfSecond
- nano-of-second, чтобы представить, от 0 до 999 999 999DateTimeException
- если значение какого-либо поля испытывает недостаток диапазонаpublic OffsetDateTime atTime(OffsetTime time)
OffsetDateTime
. Это возвращается OffsetDateTime
сформированный из этой даты в требуемое время. Все возможные комбинации даты и время допустимы.
time
- время, чтобы объединить с, не нульpublic LocalDateTime atStartOfDay()
LocalDateTime
в начале этой даты. Это возвращает a LocalDateTime
сформированный из этой даты во время полуночи, 00:00, в начале этой даты.
public ZonedDateTime atStartOfDay(ZoneId zone)
Правила часового пояса, такие как переход на летнее время, означают, что не каждая разовая датой локальная переменная допустима для указанной зоны, таким образом разовая датой локальная переменная, возможно, не полночь.
В большинстве случаев есть только одно допустимое смещение для разовой датой локальной переменной. В случае перекрытия есть два допустимых смещения, и более ранний используется, соответствуя первому возникновению полуночи в день. В случае разрыва зонное разовое датой представит момент сразу после разрыва.
Если зональный ID является a ZoneOffset
, тогда у результата всегда есть время полуночи.
Преобразовать в определенное время в данном вызове часового пояса atTime(LocalTime)
сопровождаемый LocalDateTime.atZone(ZoneId)
.
zone
- зональный ID, чтобы использовать, не нульpublic long toEpochDay()
ChronoLocalDate
Epoch Day count
простое количество постепенного увеличения дней, где день 0 01.01.1970 (ISO). Это определение является тем же самым для всех хронологий, включая преобразованию.
Эта реализация по умолчанию запрашивает EPOCH_DAY
поле.
toEpochDay
в интерфейсе ChronoLocalDate<LocalDate>
public int compareTo(ChronoLocalDate<?> other)
Сравнение прежде всего базируется в день от самого раннего до последнего. Это является "непротиворечивым с, равняется", как определено Comparable
.
Если все сравниваемые даты являются экземплярами LocalDate
, тогда сравнение будет полностью базироваться в день. Если некоторые сравниваемые даты находятся в различных хронологиях, то хронологию также рассматривают, см. ChronoLocalDate.compareTo(java.time.chrono.ChronoLocalDate<?>)
.
compareTo
в интерфейсе Comparable<ChronoLocalDate<?>>
compareTo
в интерфейсе ChronoLocalDate<LocalDate>
other
- другая дата, чтобы сравнить с, не нульpublic boolean isAfter(ChronoLocalDate<?> other)
Это проверяет, чтобы видеть, представляет ли эта дата точку на локальной временной шкале после другой даты.
LocalDate a = LocalDate.of(2012, 6, 30); LocalDate b = LocalDate.of(2012, 7, 1); a.isAfter(b) == false a.isAfter(a) == false b.isAfter(a) == true
Этот метод только рассматривает позицию этих двух дат на локальной временной шкале. Это не принимает во внимание хронологию, или календарную систему. Это отличается от сравнения в compareTo(ChronoLocalDate)
, но тот же самый подход как ChronoLocalDate.timeLineOrder()
.
isAfter
в интерфейсе ChronoLocalDate<LocalDate>
other
- другая дата, чтобы сравнить с, не нульpublic boolean isBefore(ChronoLocalDate<?> other)
Это проверяет, чтобы видеть, представляет ли эта дата точку на локальной временной шкале перед другой датой.
LocalDate a = LocalDate.of(2012, 6, 30); LocalDate b = LocalDate.of(2012, 7, 1); a.isBefore(b) == true a.isBefore(a) == false b.isBefore(a) == false
Этот метод только рассматривает позицию этих двух дат на локальной временной шкале. Это не принимает во внимание хронологию, или календарную систему. Это отличается от сравнения в compareTo(ChronoLocalDate)
, но тот же самый подход как ChronoLocalDate.timeLineOrder()
.
isBefore
в интерфейсе ChronoLocalDate<LocalDate>
other
- другая дата, чтобы сравнить с, не нульpublic boolean isEqual(ChronoLocalDate<?> other)
Это проверяет, чтобы видеть, представляет ли эта дата ту же самую точку на локальной временной шкале как другая дата.
LocalDate a = LocalDate.of(2012, 6, 30); LocalDate b = LocalDate.of(2012, 7, 1); a.isEqual(b) == false a.isEqual(a) == true b.isEqual(a) == false
Этот метод только рассматривает позицию этих двух дат на локальной временной шкале. Это не принимает во внимание хронологию, или календарную систему. Это отличается от сравнения в compareTo(ChronoLocalDate)
но тот же самый подход как ChronoLocalDate.timeLineOrder()
.
isEqual
в интерфейсе ChronoLocalDate<LocalDate>
other
- другая дата, чтобы сравнить с, не нульpublic boolean equals(Object obj)
Сравнивает это LocalDate
с другим обеспечением, что дата является тем же самым.
Только объекты типа LocalDate
сравниваются, другие типы возвращают false. Сравнить даты два TemporalAccessor
экземпляры, включая даты в двух различных хронологиях, используют ChronoField.EPOCH_DAY
как компаратор.
equals
в интерфейсе ChronoLocalDate<LocalDate>
equals
в class Object
obj
- объект проверить, обнулите, возвращает falseObject.hashCode()
, HashMap
public int hashCode()
hashCode
в интерфейсе ChronoLocalDate<LocalDate>
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92