Класс MonthDay

public static MonthDay now()

Получает текущие месяц и день по системным часам в часовом поясе по умолчанию.

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

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

public static MonthDay now(ZoneId zone)

Получает текущие месяц и день по системным часам в указанном часовом поясе.

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

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

public static MonthDay now(Clock clock)

Получает текущие месяц и день по указанным часам.

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

public static MonthDay of(Month month, int dayOfMonth)

Создает экземпляр MonthDay.

День месяца должен быть допустимым для данного месяца в високосном году. Поэтому для февраля допустим 29-й день.

Например, передача апреля и 31-го дня вызовет исключение, поскольку 31 апреля не бывает ни в одном году. В отличие от этого, передача 29 февраля разрешена, поскольку такая комбинация месяца и дня иногда может быть допустимой.

public static MonthDay of(int month, int dayOfMonth)

Создает экземпляр MonthDay.

День месяца должен быть допустимым для данного месяца в високосном году. Поэтому для месяца 2 (февраля) допустим 29-й день.

Например, передача месяца 4 (апреля) и 31-го дня вызовет исключение, поскольку 31 апреля не бывает ни в одном году. В отличие от этого, передача 29 февраля разрешена, поскольку такая комбинация месяца и дня иногда может быть допустимой.

public static MonthDay from(TemporalAccessor temporal)

Создает экземпляр MonthDay на основе временного объекта.

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

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

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

public static MonthDay parse(CharSequence text)

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

Строка должна представлять допустимую комбинацию месяца и дня. Формат: --MM-dd.

public static MonthDay parse(CharSequence text, DateTimeFormatter formatter)

Создает экземпляр MonthDay из текстовой строки с помощью заданного форматировщика.

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

public boolean isSupported(TemporalField field)

Проверяет, поддерживается ли указанное поле.

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

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

• MONTH_OF_YEAR
• YEAR

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

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

public ValueRange range(TemporalField field)

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

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

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

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

public int get(TemporalField field)

Получает значение указанного поля для этих месяца и дня в виде int.

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

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

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

public long getLong(TemporalField field)

Получает значение указанного поля для этих месяца и дня в виде long.

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

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

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

public int getMonthValue()

Получает значение поля месяца года от 1 до 12.

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

public Month getMonth()

Получает поле месяца года с помощью перечисления Month.

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

public int getDayOfMonth()

Получает значение поля дня месяца.

Этот метод возвращает примитивное значение int для дня месяца.

public boolean isValidYear(int year)

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

Этот метод проверяет, образуют ли данный месяц и день вместе с указанным годом допустимую дату. Значение false может быть возвращено только для 29 февраля.

public MonthDay withMonth(int month)

Возвращает копию этого объекта MonthDay с измененным месяцем года.

Возвращает месяц и день с указанным месяцем. Если день месяца недопустим для указанного месяца, он будет заменен последним допустимым днем месяца.

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

public MonthDay with(Month month)

Возвращает копию этого объекта MonthDay с измененным месяцем года.

Возвращает месяц и день с указанным месяцем. Если день месяца недопустим для указанного месяца, он будет заменен последним допустимым днем месяца.

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

public MonthDay withDayOfMonth(int dayOfMonth)

Возвращает копию этого объекта MonthDay с измененным днем месяца.

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

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

public <R> R query(TemporalQuery<R> query)

Выполняет запрос к этим месяцу и дню с помощью указанного запроса.

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

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

public Temporal adjustInto(Temporal temporal)

Изменяет указанный временной объект так, чтобы он содержал эти месяц и день.

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

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

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

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

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

public String format(DateTimeFormatter formatter)

Форматирует эти месяц и день с помощью указанного форматировщика.

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

public LocalDate atYear(int year)

Объединяет эти месяц и день с годом, чтобы создать LocalDate.

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

Если указаны 29 февраля, а год не является високосным, в результирующей дате этот день будет заменен на 28 февраля.

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

public int compareTo(MonthDay other)

Сравнивает эти месяц и день с другими месяцем и днем.

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

public boolean isAfter(MonthDay other)

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

public boolean isBefore(MonthDay other)

Проверяет, идут ли эти месяц и день раньше указанной комбинации месяца и дня.

public boolean equals(Object obj)

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

Сравнение основано на положении месяца и дня в течение года.

public int hashCode()

Хеш-код для этих месяца и дня.

public String toString()

Представляет эти месяц и день в виде String, например --12-03.

Результат будет представлен в формате --MM-dd: