Класс Period

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

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

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

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

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

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

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

Если величина является временной величиной, то она должна использовать хронологию 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) для доступа ко всему состоянию периода.

Хронология представляет собой систему календаря, используемую. Система календаря 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'.