Интерфейс ChronoLocalDate

Этот компаратор отличается от сравнения в compareTo(ChronoLocalDate) тем, что сравнивает только лежащую в основе дату, но не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе положения даты на локальной временной шкале. Сравнение выполняется так же, как сравнение количества дней от эпохи.

Этот метод получает локальную дату на основе указанного объекта временных данных. TemporalAccessor представляет собой произвольный набор сведений о дате и времени, который эта фабрика преобразует в экземпляр ChronoLocalDate.

Преобразование извлекает и объединяет хронологию и дату из объекта временных данных. Поведение эквивалентно использованию Chronology.date(TemporalAccessor) с извлечённой хронологией. Реализациям разрешается выполнять оптимизацию, например обращаться к полям, эквивалентным соответствующим объектам.

Сигнатура этого метода соответствует сигнатуре функционального интерфейса TemporalQuery, что позволяет использовать его в качестве запроса через ссылку на метод, ChronoLocalDate::from.

Chronology представляет используемую календарную систему. Эра и другие поля в ChronoField определяются хронологией.

Эра концептуально является крупнейшим делением временной шкалы. В большинстве календарных систем есть одна эпоха, разделяющая временную шкалу на две эры. Однако в некоторых системах несколько эр, например по одной на период правления каждого лидера. Точное значение определяется Chronology.

Все правильно реализованные классы Era являются одиночками, поэтому допустимо написать код date.getEra() == SomeChrono.ERA_NAME).

В этой реализации по умолчанию используется Chronology.eraOf(int).

Високосный год длиннее обычного. Точное значение определяется хронологией с тем ограничением, что продолжительность високосного года должна превышать продолжительность невисокосного года.

В этой реализации по умолчанию используется Chronology.isLeapYear(long).

Возвращает продолжительность месяца в днях.

Возвращает продолжительность года в днях.

В реализации по умолчанию используется isLeapYear(), которая возвращает 365 или 366.

Проверяет, можно ли запросить указанное поле для этой даты. Если результат равен false, вызов методов range, get и with(TemporalField, long) приведёт к исключению.

Набор поддерживаемых полей определяется хронологией и обычно включает все поля даты ChronoField.

Если поле не является ChronoField, результат этого метода определяется вызовом TemporalField.isSupportedBy(TemporalAccessor) с передачей this в качестве аргумента. Поддержка поля определяется самим полем.

Проверяет, можно ли прибавить указанную единицу измерения к этой дате или вычесть её из этой даты. Если результат равен false, вызов методов plus(long, TemporalUnit) и minus приведёт к исключению.

Набор поддерживаемых единиц измерения определяется хронологией и обычно включает все единицы даты ChronoUnit, кроме FOREVER.

Если единица измерения не является ChronoUnit, результат этого метода определяется вызовом TemporalUnit.isSupportedBy(Temporal) с передачей this в качестве аргумента. Поддержка единицы измерения определяется самой единицей.

Этот метод корректирует дату и время согласно правилам указанного средства корректировки. Простое средство корректировки может просто установить одно из полей, например поле года. Более сложное средство корректировки может установить дату на последний день месяца. Набор распространённых корректировок представлен в TemporalAdjusters. К ним относятся поиск «последнего дня месяца» и «следующей среды». Средство корректировки отвечает за обработку особых случаев, таких как различная продолжительность месяцев и високосные годы.

Примеры кода, показывающие, как и зачем используется этот метод:

 date = date.with(Month.JULY);        // most key classes implement TemporalAdjuster
 date = date.with(lastDayOfMonth());  // static import from Adjusters
 date = date.with(next(WEDNESDAY));   // static import from Adjusters and DayOfWeek

Возвращает новый объект на основе этого, в котором изменено значение указанного поля. Например, для LocalDate этот метод можно использовать для установки года, месяца или дня месяца. Возвращённый объект будет иметь тот же наблюдаемый тип, что и этот объект.

В некоторых случаях изменение поля определено не полностью. Например, если целевой объект — дата, представляющая 31 января, изменение месяца на февраль будет неоднозначным. В таких случаях поле отвечает за определение результата. Как правило, выбирается предыдущая допустимая дата — в данном примере последний допустимый день февраля.

Этот метод корректирует временной объект, выполняя сложение согласно правилам указанной величины. Обычно величина представляет собой Period, но может иметь любой другой тип, реализующий интерфейс TemporalAmount, например Duration.

Примеры кода, показывающие, как и зачем используется этот метод:

 date = date.plus(period);                // add a Period instance
 date = date.plus(duration);              // add a Duration instance
 date = date.plus(workingDays(6));        // example user-written workingDays method

Обратите внимание: вызов plus, а затем minus не гарантирует возврат того же значения даты и времени.

Этот метод возвращает новый объект на основе этого, к которому прибавлен указанный период. Например, для LocalDate этот метод можно использовать для прибавления нескольких лет, месяцев или дней. Возвращённый объект будет иметь тот же наблюдаемый тип, что и этот объект.

В некоторых случаях изменение поля определено не полностью. Например, если целевой объект — дата, представляющая 31 января, прибавление одного месяца будет неоднозначным. В таких случаях поле отвечает за определение результата. Как правило, выбирается предыдущая допустимая дата — в данном примере последний допустимый день февраля.

Этот метод корректирует временной объект, выполняя вычитание согласно правилам указанной величины. Обычно величина представляет собой Period, но может иметь любой другой тип, реализующий интерфейс TemporalAmount, например Duration.

Примеры кода, показывающие, как и зачем используется этот метод:

 date = date.minus(period);               // subtract a Period instance
 date = date.minus(duration);             // subtract a Duration instance
 date = date.minus(workingDays(6));       // example user-written workingDays method

Обратите внимание: вызов plus, а затем minus не гарантирует возврат того же значения даты и времени.

Этот метод возвращает новый объект на основе этого, из которого вычтен указанный период. Например, для LocalDate этот метод можно использовать для вычитания нескольких лет, месяцев или дней. Возвращённый объект будет иметь тот же наблюдаемый тип, что и этот объект.

В некоторых случаях изменение поля определено не полностью. Например, если целевой объект — дата, представляющая 31 марта, вычитание одного месяца будет неоднозначным. В таких случаях поле отвечает за определение результата. Как правило, выбирается предыдущая допустимая дата — в данном примере последний допустимый день февраля.

Этот метод выполняет запрос к этой дате с помощью указанного объекта стратегии запроса. Объект TemporalQuery определяет логику получения результата. Чтобы узнать, каким будет результат этого метода, ознакомьтесь с документацией запроса.

Результат этого метода получается вызовом метода TemporalQuery.queryFrom(TemporalAccessor) для указанного запроса с передачей this в качестве аргумента.

Возвращает временной объект того же наблюдаемого типа, что и входной объект, с датой, изменённой на дату этого объекта.

Корректировка эквивалентна использованию 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);

Этот экземпляр неизменяем и не изменяется при вызове данного метода.

Вычисляет промежуток времени между двумя объектами ChronoLocalDate в одной TemporalUnit. Начальной и конечной точками являются this и указанная дата. Результат будет отрицательным, если конечная дата предшествует начальной. Переданный этому методу объект Temporal преобразуется в ChronoLocalDate с помощью Chronology.date(TemporalAccessor). Вычисление возвращает целое число, представляющее количество полных единиц между двумя датами. Например, количество дней между двумя датами можно вычислить с помощью startDate.until(endDate, DAYS).

Этот метод можно использовать двумя эквивалентными способами. Первый — вызвать его непосредственно. Второй — использовать TemporalUnit.between(Temporal, Temporal):

  // these two lines are equivalent
  amount = start.until(end, MONTHS);
  amount = MONTHS.between(start, end);

Вычисление реализовано в этом методе для ChronoUnit. Все реализации должны поддерживать единицы DAYS, WEEKS, MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA и ERAS. Для других значений ChronoUnit будет выброшено исключение.

Если единица измерения не является ChronoUnit, результат этого метода определяется вызовом TemporalUnit.between(Temporal, Temporal) с передачей this в качестве первого аргумента, а преобразованного входного временного объекта — в качестве второго аргумента.

Этот экземпляр неизменяем и не изменяется при вызове данного метода.

Вычисляет период между двумя датами. Все предоставляемые хронологии вычисляют период в годах, месяцах и днях, однако API ChronoPeriod позволяет представлять период в других единицах.

Начальной и конечной точками являются this и указанная дата. Результат будет отрицательным, если конечная дата предшествует начальной. Знак будет одинаковым для года, месяца и дня.

Вычисление выполняется с использованием хронологии этой даты. При необходимости входная дата преобразуется в соответствующий формат.

Этот экземпляр неизменяем и не изменяется при вызове данного метода.

Эта дата передаётся форматтеру для получения строки.

Реализация по умолчанию должна работать следующим образом:

 return formatter.format(this);

Возвращает ChronoLocalDateTime, образованные этой датой и указанным временем. Допустимы все возможные сочетания даты и времени.

Поле Epoch Day count представляет собой простой возрастающий счётчик дней, где день 0 — это 1970-01-01 (ISO). Это определение одинаково для всех хронологий и позволяет выполнять преобразования.

В этой реализации по умолчанию запрашивается поле EPOCH_DAY.

Сначала сравниваются лежащие в основе даты на временной шкале, затем хронологии. Сравнение «согласовано с equals» согласно определению Comparable.

Например, порядок сравнения будет следующим:

1. 2012-12-03 (ISO)
2. 2012-12-04 (ISO)
3. 2555-12-04 (ThaiBuddhist)
4. 2012-12-05 (ISO)

Если все сравниваемые объекты даты относятся к одной хронологии, дополнительный этап сравнения хронологий не требуется и используются только локальные даты. Чтобы сравнить даты двух экземпляров TemporalAccessor, включая даты из разных хронологий, используйте ChronoField.EPOCH_DAY в качестве компаратора.

Эта реализация по умолчанию выполняет описанное выше сравнение.

Этот метод отличается от сравнения в compareTo(ChronoLocalDate) тем, что сравнивает только лежащую в основе дату, но не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе положения на временной шкале. Это эквивалентно использованию date1.toEpochDay() > date2.toEpochDay().

В этой реализации по умолчанию сравнение выполняется на основе количества дней от эпохи.

Этот метод отличается от сравнения в compareTo(ChronoLocalDate) тем, что сравнивает только лежащую в основе дату, но не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе положения на временной шкале. Это эквивалентно использованию date1.toEpochDay() < date2.toEpochDay().

В этой реализации по умолчанию сравнение выполняется на основе количества дней от эпохи.

Этот метод отличается от сравнения в compareTo(ChronoLocalDate) тем, что сравнивает только лежащую в основе дату, но не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе положения на временной шкале. Это эквивалентно использованию date1.toEpochDay() == date2.toEpochDay().

В этой реализации по умолчанию сравнение выполняется на основе количества дней от эпохи.

Сравнивает эту дату с другой, проверяя, что даты и хронологии совпадают.

Чтобы сравнить даты двух экземпляров TemporalAccessor, включая даты в двух разных хронологиях, используйте ChronoField.EPOCH_DAY в качестве компаратора.

Вывод будет содержать полную местную дату.