Интерфейс ChronoLocalDate

Этот компаратор отличается от сравнения в compareTo(java.time.chrono.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(java.time.chrono.ChronoLocalDate) тем, что сравнивает только базовую дату, а не хронологию. Это позволяет сравнивать даты в разных календарных системах на основе их позиции на временной шкале. Это эквивалентно использованию date1.toEpochDay() > date2.toEpochDay().

Эта реализация по умолчанию выполняет сравнение на основе эпохального дня.

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

Эта реализация по умолчанию выполняет сравнение на основе эпохального дня.

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

Эта реализация по умолчанию выполняет сравнение на основе эпохального дня.

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

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

Вывод будет включать полную локальную дату.