Интерфейс ChronoPeriod

Получает период, представляющий собой промежуток времени между двумя датами.

Начальная дата включена, а конечная — нет. Период рассчитывается с помощью ChronoLocalDate.until(ChronoLocalDate). Таким образом, вычисление зависит от хронологии.

Для расчета используется хронология первой даты. Хронология второй даты игнорируется, а сама дата преобразуется в целевую хронологическую систему до начала расчета.

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

Получает значение запрошенной единицы измерения.

Поддерживаемые единицы измерения зависят от хронологии. Обычно это YEARS, MONTHS и DAYS. Запрос несуществующей единицы измерения вызовет исключение.

Возвращает набор единиц измерения, поддерживаемых этим периодом.

Поддерживаемые единицы измерения зависят от хронологии. Обычно это YEARS, MONTHS и DAYS. Они возвращаются в порядке убывания важности.

Этот набор можно использовать совместно с get(TemporalUnit) для доступа ко всему состоянию периода.

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

Период определяется хронологией. Она управляет поддерживаемыми единицами измерения и ограничивает сложение/вычитание экземплярами той же хронологии.

Возвращает копию этого периода, с добавленным указанным периодом.

Если указанное количество — это ChronoPeriod, то оно должно иметь ту же хронологию, что и этот период. Реализации могут выбирать принимать или отклонять другие TemporalAmount реализации.

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

Возвращает копию этого периода, с вычтенным указанным периодом.

Если указанное количество — это ChronoPeriod, то оно должно иметь ту же хронологию, что и этот период. Реализации могут выбирать принимать или отклонять другие TemporalAmount реализации.

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

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

Это возвращает период, в котором каждая поддерживаемая единица измерения умножается индивидуально. Например, период "2 года, -3 месяца и 4 дня", умноженный на 3, вернет "6 лет, -9 месяцев и 12 дней". Нормализация не выполняется.

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

Это возвращает период, в котором каждая поддерживаемая единица измерения изменяется на противоположное. Например, период "2 года, -3 месяца и 4 дня" будет изменён на "-2 года, 3 месяца и -4 дня". Нормализация не выполняется.

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

Процесс нормализации специфичен для каждой системы календаря. Например, в системе календаря ISO года и месяцы нормализуются, но дни нет, так что «15 месяцев» будут нормализованы в «1 год и 3 месяца».

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

Добавляет этот период к указанному временному объекту.

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

В большинстве случаев яснее использовать обратный порядок вызова, используя Temporal.plus(TemporalAmount).

// these two lines are equivalent, but the second approach is recommended
   dateTime = thisPeriod.addTo(dateTime);
   dateTime = dateTime.plus(thisPeriod);

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

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

Вычитает этот период из указанного временного объекта.

Это возвращает временной объект того же типа, что и входной, с вычтенным этим периодом.

В большинстве случаев яснее использовать обратный порядок вызова, используя Temporal.minus(TemporalAmount).

// these two lines are equivalent, but the second approach is recommended
   dateTime = thisPeriod.subtractFrom(dateTime);
   dateTime = dateTime.minus(thisPeriod);

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

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

Проверяет, равен ли этот период другому периоду, включая хронологию.

Сравнивает этот период с другим, гарантируя, что тип, каждое значение и хронология совпадают. Обратите внимание, что это означает, что период «15 месяцев» не равен периоду «1 год и 3 месяца».

Выводит этот период в виде String.

Вывод будет содержать значения периода и хронологию.