Класс YearMonth

Для получения текущих года и месяца выполняется запрос к system clock в часовом поясе по умолчанию.

Использование этого метода не позволит использовать альтернативные часы для тестирования, так как часы заданы жестко.

Для получения текущих года и месяца выполняется запрос к system clock. Указание часового пояса позволяет избежать зависимости от часового пояса по умолчанию.

Использование этого метода не позволит использовать альтернативные часы для тестирования, так как часы заданы жестко.

Для получения текущих года и месяца выполняется запрос к указанным часам. Использование этого метода позволяет применять альтернативные часы для тестирования. Альтернативные часы можно создать с помощью dependency injection.

Год и месяц определяются на основе указанного объекта времени. TemporalAccessor представляет произвольный набор сведений о дате и времени, который эта фабрика преобразует в экземпляр YearMonth.

В ходе преобразования извлекаются поля YEAR и MONTH_OF_YEAR. Извлечение допускается только в том случае, если объект времени использует хронологию ISO или может быть преобразован в LocalDate.

Сигнатура этого метода соответствует функциональному интерфейсу TemporalQuery, что позволяет использовать его как запрос посредством ссылки на метод, YearMonth::from.

Строка должна представлять допустимые год и месяц. Формат должен быть uuuu-MM. Перед годами, выходящими за диапазон от 0000 до 9999, необходимо указывать знак плюса или минуса.

Текст разбирается с помощью форматировщика, в результате чего возвращаются год и месяц.

Проверяет, можно ли получить из этих года и месяца значение указанного поля. Если нет, вызовы методов range, get и with(TemporalField, long) приведут к выбросу исключения.

Если поле является ChronoField, запрос обрабатывается здесь. Поддерживаются следующие поля:

• MONTH_OF_YEAR
• PROLEPTIC_MONTH
• YEAR_OF_ERA
• YEAR
• ERA

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.isSupportedBy(TemporalAccessor) с аргументом this. Поддержка поля определяется самим полем.

Проверяет, можно ли прибавить указанную единицу измерения к этим году и месяцу или вычесть ее из них. Если нет, вызовы методов plus(long, TemporalUnit) и minus приведут к выбросу исключения.

Если единица измерения является ChronoUnit, запрос обрабатывается здесь. Поддерживаются следующие единицы измерения:

• MONTHS
• YEARS
• DECADES
• CENTURIES
• MILLENNIA
• ERAS

Если единица измерения не является ChronoUnit, результат этого метода получается вызовом TemporalUnit.isSupportedBy(Temporal) с аргументом this. Поддержка единицы измерения определяется самой единицей.

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

Если поле является ChronoField, запрос обрабатывается здесь. Метод supported fields возвращает подходящие экземпляры диапазона. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.rangeRefinedBy(TemporalAccessor) с аргументом this. Возможность получения диапазона определяется самим полем.

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

Если поле является ChronoField, запрос обрабатывается здесь. Метод supported fields возвращает допустимые значения на основе этих года и месяца, за исключением PROLEPTIC_MONTH, которое слишком велико, чтобы поместиться в int, и приводит к выбросу DateTimeException. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.getFrom(TemporalAccessor) с аргументом this. Возможность получения значения и его смысл определяются самим полем.

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

Если поле является ChronoField, запрос обрабатывается здесь. Метод supported fields возвращает допустимые значения на основе этих года и месяца. Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.getFrom(TemporalAccessor) с аргументом this. Возможность получения значения и его смысл определяются самим полем.

Этот метод возвращает значение года примитивного типа int.

Метод возвращает год в пролептическом представлении согласно get(YEAR).

Этот метод возвращает месяц как значение типа int в диапазоне от 1 до 12. В коде приложения обычно яснее использовать перечисление Month, вызвав getMonth().

Этот метод возвращает для месяца значение перечисления Month. Это позволяет избежать неоднозначности в значениях int. Если требуется получить значение примитивного типа int, перечисление предоставляет метод int value.

Этот метод применяет действующие правила определения високосных лет ко всей временной шкале. В общем случае год является високосным, если он делится на четыре без остатка. Однако годы, делящиеся на 100, не являются високосными, за исключением годов, делящихся на 400.

Например, 1904 год является високосным, поскольку делится на 4. 1900 год не был високосным, поскольку делится на 100, однако 2000 год был високосным, поскольку делится на 400.

Расчет является пролептическим: те же правила применяются к далекому будущему и далекому прошлому. Это исторически неточно, но соответствует стандарту ISO-8601.

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

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

Возвращает количество дней в году: 365 или 366.

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

Простой настройщик может просто задать значение одного из полей, например года. Более сложный настройщик может установить год и месяц, соответствующие следующему пролету кометы Галлея мимо Земли.

Результат этого метода получается вызовом метода TemporalAdjuster.adjustInto(Temporal) для указанного настройщика с аргументом this.

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

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

Если поле является ChronoField, корректировка выполняется здесь. Поддерживаемые поля обрабатываются следующим образом:

• MONTH_OF_YEAR — возвращает YearMonth с указанным месяцем года. Год не изменяется.
• PROLEPTIC_MONTH — возвращает YearMonth с указанным пролептическим месяцем. Год и месяц этого объекта заменяются полностью.
• YEAR_OF_ERA — возвращает YearMonth с указанным годом эры. Месяц и эра не изменяются.
• YEAR — возвращает YearMonth с указанным годом. Месяц не изменяется.
• ERA — возвращает YearMonth с указанной эрой. Месяц и год эры не изменяются.

Во всех случаях, если новое значение выходит за пределы допустимого диапазона значений поля, выбрасывается DateTimeException.

Для всех остальных экземпляров ChronoField выбрасывается UnsupportedTemporalTypeException.

Если поле не является ChronoField, результат этого метода получается вызовом TemporalField.adjustInto(Temporal, long) с аргументом this. В этом случае возможность и способ корректировки определяются самим полем.

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

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

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

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

Вычисление делегируется объекту величины посредством вызова TemporalAmount.addTo(Temporal). Реализация величины может выполнять сложение любым способом, однако обычно она вызывает plus(long, TemporalUnit). Чтобы определить, можно ли успешно прибавить величину, ознакомьтесь с документацией по ее реализации.

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

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

Если единица измерения является ChronoUnit, сложение выполняется здесь. Поддерживаемые единицы обрабатываются следующим образом:

• MONTHS — возвращает YearMonth с указанным количеством прибавленных месяцев. Эквивалентно вызову plusMonths(long).
• YEARS — возвращает YearMonth с указанным количеством прибавленных лет. Эквивалентно вызову plusYears(long).
• DECADES — возвращает YearMonth с указанным количеством прибавленных десятилетий. Эквивалентно вызову plusYears(long) с величиной, умноженной на 10.
• CENTURIES — возвращает YearMonth с указанным количеством прибавленных столетий. Эквивалентно вызову plusYears(long) с величиной, умноженной на 100.
• MILLENNIA — возвращает YearMonth с указанным количеством прибавленных тысячелетий. Эквивалентно вызову plusYears(long) с величиной, умноженной на 1 000.
• ERAS — возвращает YearMonth с указанным количеством прибавленных эр. Поддерживаются только две эры, поэтому величина должна равняться единице, нулю или минус единице. Если величина не равна нулю, год изменяется так, чтобы год эры остался прежним.

Для всех остальных экземпляров ChronoUnit выбрасывается UnsupportedTemporalTypeException.

Если единица измерения не является ChronoUnit, результат этого метода получается вызовом TemporalUnit.addTo(Temporal, long) с аргументом this. В этом случае возможность и способ выполнения сложения определяются самой единицей измерения.

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

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

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

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

Вычисление делегируется объекту величины вызовом метода TemporalAmount.subtractFrom(Temporal). Реализация величины может выполнять вычитание любым способом, однако обычно она вызывает minus(long, TemporalUnit). Чтобы определить, можно ли успешно вычесть эту величину, обратитесь к документации ее реализации.

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

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

Этот метод эквивалентен методу plus(long, TemporalUnit) с величиной, взятой с противоположным знаком. Полное описание того, как выполняется сложение и, следовательно, вычитание, приведено в документации этого метода.

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

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

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

Запрос к этому году-месяцу выполняется с помощью указанного объекта стратегии запроса. Объект TemporalQuery определяет логику получения результата. Ознакомьтесь с документацией запроса, чтобы понять, каким будет результат этого метода.

Результат этого метода получается вызовом метода TemporalQuery.queryFrom(TemporalAccessor) у указанного запроса с передачей this в качестве аргумента.

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

Изменение эквивалентно использованию Temporal.with(TemporalField, long) с передачей ChronoField.PROLEPTIC_MONTH в качестве поля. Если указанный временной объект не использует календарную систему ISO, выбрасывается DateTimeException.

В большинстве случаев понятнее изменить порядок вызова и использовать Temporal.with(TemporalAdjuster):

  // these two lines are equivalent, but the second approach is recommended
  temporal = thisYearMonth.adjustInto(temporal);
  temporal = temporal.with(thisYearMonth);

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

Вычисляет время между двумя объектами YearMonth в единицах одной TemporalUnit. Начальной и конечной точками являются this и указанный год-месяц. Результат будет отрицательным, если конечная точка предшествует начальной. Переданный этому методу объект Temporal преобразуется в YearMonth с помощью from(TemporalAccessor). Например, количество лет между двумя годами-месяцами можно вычислить с помощью startYearMonth.until(endYearMonth, YEARS).

Вычисление возвращает целое число, обозначающее количество полных единиц между двумя годами-месяцами. Например, промежуток между 2012-06 и 2032-05 составляет всего одно десятилетие, поскольку до двух десятилетий не хватает одного месяца.

Этот метод можно использовать двумя эквивалентными способами. Первый — вызвать данный метод. Второй — использовать TemporalUnit.between(Temporal, Temporal):

  // these two lines are equivalent
  amount = start.until(end, MONTHS);
  amount = MONTHS.between(start, end);

В этом методе реализованы вычисления для ChronoUnit. Поддерживаются единицы MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA и ERAS. Для других значений ChronoUnit выбрасывается исключение.

Если единица не является ChronoUnit, результат этого метода получается вызовом TemporalUnit.between(Temporal, Temporal) с передачей this в качестве первого аргумента, а преобразованного входного временного объекта — в качестве второго аргумента.

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

Этот год-месяц передается форматировщику для получения строки.

Возвращает LocalDate, образованную этим годом-месяцем и указанным днем месяца.

Значение дня месяца должно быть допустимым для этого года-месяца.

Этот метод можно использовать в цепочке вызовов для создания даты:

 LocalDate date = year.atMonth(month).atDay(day);

Возвращает LocalDate на основе этого года-месяца. День месяца устанавливается в последний допустимый день месяца с учетом високосных лет.

Этот метод можно использовать в цепочке вызовов для создания даты:

 LocalDate date = year.atMonth(month).atEndOfMonth();

Сначала сравниваются значения года, затем значения месяца. Сравнение «согласовано с equals» в соответствии с определением Comparable.

Сравнение основано на положении годов-месяцев на временной шкале.

Результат будет иметь формат uuuu-MM: