Класс Период

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

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

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

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

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

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

Преобразование проходит по набору единиц из количества и использует 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'.