Класс Period

Результирующий период будет содержать указанное количество лет. Единицы месяцев и дней будут равны нулю.

Результирующий период будет содержать указанное количество месяцев. Единицы лет и дней будут равны нулю.

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

Результирующий период будет содержать указанное количество дней. Единицы лет и месяцев будут равны нулю.

Создаёт экземпляр на основе лет, месяцев и дней.

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

Преобразование проходит по набору единиц из величины и использует единицы YEARS, MONTHS и DAYS для создания периода. Если найдены другие единицы, то выбрасывается исключение.

Если величина является ChronoPeriod, то она должна использовать хронологию ISO.

Парсит строку, полученную с помощью toString(), которая основана на форматах периода ISO-8601 PnYnMnD и PnW.

Строка начинается с необязательного знака, обозначаемого знаком ASCII минус или плюс. Если отрицательный, весь период инвертируется. Последующая буква ASCII "P" в верхнем или нижнем регистре. Затем четыре раздела, каждый из которых состоит из числа и суффикса. По крайней мере, один из четырех разделов должен быть присутствующим. Разделы имеют суффиксы ASCII "Y", "M", "W" и "D" для лет, месяцев, недель и дней, которые могут быть в верхнем или нижнем регистре. Суффиксы должны идти в порядке. Часть числа каждого раздела должна состоять из цифр ASCII. Число может быть префиксным знаком ASCII минус или плюс. Число должно быть преобразовано в int.

Ведущий знак плюс/минус, и отрицательные значения для других единиц не входят в стандарт ISO-8601. Кроме того, ISO-8601 не допускает смешивания между форматами PnYnMnD и PnW. Любой ввод, основанный на неделях, умножается на 7 и рассматривается как количество дней.

Например, следующие являются допустимыми входами:

   "P2Y"             -- Period.ofYears(2)
   "P3M"             -- Period.ofMonths(3)
   "P4W"             -- Period.ofWeeks(4)
   "P5D"             -- Period.ofDays(5)
   "P1Y2M3D"         -- Period.of(1, 2, 3)
   "P1Y2M3W4D"       -- Period.of(1, 2, 25)
   "P-1Y2M"          -- Period.of(-1, 2, 0)
   "-P1Y2M"          -- Period.of(-1, -2, 0)
 

Начальная дата включена, а конечная - нет. Период рассчитывается путём удаления полных месяцев, а затем вычисления оставшегося количества дней, корректируя, чтобы оба имели одинаковый знак. Количество месяцев затем разбивается на годы и месяцы на основе года в 12 месяцев. Месяц считается, если конечный день месяца больше или равен начальному дню месяца. Например, от 2010-01-15 до 2011-03-18 составляет один год, два месяца и три дня.

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

Возвращает значение для каждой из трёх поддерживаемых единиц, YEARS, MONTHS и DAYS. Все остальные единицы выбрасывают исключение.

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

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

Chronology представляет собой систему календаря, используемую. Система календаря ISO-8601 является современной гражданской системой календаря, используемой сегодня в большинстве стран мира. Она эквивалентна пролептическому григорианскому календарю, в котором сегодняшние правила високосных лет применяются для всего времени.

Период нулевой длины имеет значение ноль для единиц лет, месяцев и дней.

Проверяет, являются ли единицы лет, месяцев или дней меньше нуля.

Возвращает единицу лет.

Единица месяцев не нормализуется автоматически с единицей лет. Это означает, что период "15 месяцев" отличается от периода "1 год и 3 месяца".

Возвращает единицу месяцев.

Единица месяцев не нормализуется автоматически с единицей лет. Это означает, что период "15 месяцев" отличается от периода "1 год и 3 месяца".

Возвращает значение для единиц дней.

Устанавливает количество единиц лет в копии данного периода. Единицы месяцев и дней не затрагиваются.

Единицы месяцев не нормализуются автоматически с единицами лет. Это означает, что период "15 месяцев" отличается от периода "1 год и 3 месяца".

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

Устанавливает количество единиц месяцев в копии данного периода. Единицы лет и дней не затрагиваются.

Единицы месяцев не нормализуются автоматически с единицами лет. Это означает, что период "15 месяцев" отличается от периода "1 год и 3 месяца".

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

Устанавливает количество единиц дней в копии данного периода. Единицы лет и месяцев не затрагиваются.

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

Работает отдельно с годами, месяцами и днями. Нормализация не выполняется.

Например, "1 год, 6 месяцев и 3 дня" плюс "2 года, 2 месяца и 2 дня" возвращает "3 года, 8 месяцев и 5 дней".

Указанное значение обычно является экземпляром Period. Другие типы интерпретируются с помощью from(TemporalAmount).

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

Добавляет значение к единицам лет в копии данного периода. Единицы месяцев и дней не затрагиваются. Например, "1 год, 6 месяцев и 3 дня" плюс 2 года возвращает "3 года, 6 месяцев и 3 дня".

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

Добавляет значение к единицам месяцев в копии данного периода. Единицы лет и дней не затрагиваются. Например, "1 год, 6 месяцев и 3 дня" плюс 2 месяца возвращает "1 год, 8 месяцев и 3 дня".

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

Добавляет значение к единицам дней в копии данного периода. Единицы лет и месяцев не затрагиваются. Например, "1 год, 6 месяцев и 3 дня" плюс 2 дня возвращает "1 год, 6 месяцев и 5 дней".

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

Работает отдельно с годами, месяцами и днями. Нормализация не выполняется.

Например, "1 год, 6 месяцев и 3 дня" минус "2 года, 2 месяца и 2 дня" возвращает "-1 год, 4 месяца и 1 день".

Указанное значение обычно является экземпляром Period. Другие типы интерпретируются с помощью from(TemporalAmount).

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

Вычитает значение из единиц лет в копии данного периода. Единицы месяцев и дней не затрагиваются. Например, "1 год, 6 месяцев и 3 дня" минус 2 года возвращает "-1 год, 6 месяцев и 3 дня".

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

Вычитает значение из единиц месяцев в копии данного периода. Единицы лет и дней не затрагиваются. Например, "1 год, 6 месяцев и 3 дня" минус 2 месяца возвращает "1 год, 4 месяца и 3 дня".

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

Вычитает значение из единиц дней в копии данного периода. Единицы лет и месяцев не затрагиваются. Например, "1 год, 6 месяцев и 3 дня" минус 2 дня возвращает "1 год, 6 месяцев и 1 день".

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

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

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

Это нормализует единицы лет и месяцев, оставив единицы дней неизменными. Единица месяцев корректируется так, чтобы ее абсолютное значение было меньше 12, а единица лет корректируется для компенсации. Например, период "1 год и 15 месяцев" будет нормализован до "2 года и 3 месяца".

Знак единиц лет и месяцев останется прежним после нормализации. Например, период "1 год и -25 месяцев" будет нормализован до "-1 год и -1 месяц".

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

Это возвращает общее количество месяцев в периоде, умножая количество лет на 12 и добавляя количество месяцев.

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

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

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

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

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

Этот подход гарантирует, что частичный период может быть добавлен к частичной дате. Например, период лет и/или месяцев может быть добавлен к YearMonth, но период, включающий дни, не может. Подход также добавляет годы и месяцы вместе при необходимости, что гарантирует правильное поведение в конце месяца.

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

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

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

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

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

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

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

Сравнение основано на типе Period и каждом из трёх значений. Чтобы быть равными, годы, месяцы и дни должны быть равны по отдельности. Обратите внимание, что это означает, что период "15 месяцев" не равен периоду "1 год и 3 месяца".

Вывод будет в формате периода ISO-8601. Нулевой период будет представлен как ноль дней, 'P0D'.