Класс Year

public static final int MIN_VALUE

public static final int MAX_VALUE

public static Year now()

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

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

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

public static Year now(ZoneId zone)

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

Это запросит system clock для получения текущего года. Указание часового пояса предотвращает зависимость от часового пояса по умолчанию.

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

public static Year now(Clock clock)

Получает текущий год из указанных часов.

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

public static Year of(int isoYear)

Получает экземпляр Year.

Этот метод принимает значение года из пролептической системы ISO-календаря.

Год 2 н.э./н. э. представлен 2.
Год 1 н. э./н. э. представлен 1.
Год 1 до н. э./до н. э. представлен 0.
Год 2 до н. э./до н. э. представлен -1.

public static Year from(TemporalAccessor temporal)

Получает экземпляр Year из временного объекта.

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

Преобразование извлекает поле year. Извлечение разрешено только если временной объект имеет хронологию ISO или может быть преобразован в LocalDate.

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

public static Year parse(CharSequence text)

Получает экземпляр Year из текстовой строки, такой как 2007.

Строка должна представлять действительный год. Годы вне диапазона от 0000 до 9999 должны быть префиксны знаком плюс или минус.

public static Year parse(CharSequence text,
                         DateTimeFormatter formatter)

Получает экземпляр Year из текстовой строки с использованием конкретного форматера.

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

public static boolean isLeap(long year)

Проверяет, является ли год високосным годом по правилам пролептической системы календаря ISO.

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

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

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

public int getValue()

Получает значение года.

Год, возвращённый этим методом, является пролептическим, как указано в get(YEAR).

public boolean isSupported(TemporalField field)

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

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

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

• YEAR_OF_ERA
• YEAR
• ERA

Все остальные ChronoField экземпляры вернут false.

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

public boolean isSupported(TemporalUnit unit)

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

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

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

• YEARS
• DECADES
• CENTURIES
• MILLENNIA
• ERAS

Все остальные ChronoUnit экземпляры вернут false.

Если период не является ChronoUnit, то результат этого метода получается путём вызова TemporalUnit.isSupportedBy(Temporal) с 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 boolean isLeap()

Проверяет, является ли год високосным по правилам ISO пролептического календаря.

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

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

Вычисление является пролептическим — применение одних и тех же правил в далеком будущем и далеком прошлом. Это исторически неточно, но верно для стандарта ISO-8601.

public boolean isValidMonthDay(MonthDay monthDay)

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

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

public int length()

public Year with(TemporalAdjuster adjuster)

Возвращает скопированную версию этого года с внесенной корректировкой.

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

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

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

public Year with(TemporalField field,
                 long newValue)

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

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

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

• YEAR_OF_ERA - Возвращает Year с указанным годом эры. Эра не изменится.
• YEAR - Возвращает Year с указанным годом. Это полностью заменяет дату и эквивалентно of(int).
• ERA - Возвращает Year с указанной эрой. Год эры не изменится.

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

Все другие ChronoField экземпляры будут выбрасывать UnsupportedTemporalTypeException.

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

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

public Year plus(TemporalAmount amountToAdd)

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

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

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

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

public Year plus(long amountToAdd,
                 TemporalUnit unit)

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

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

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

• YEARS - Возвращает Year с добавленным указанным числом лет. Эквивалентно plusYears(long).
• DECADES - Возвращает Year с добавленным указанным числом десятилетий. Эквивалентно вызову plusYears(long) со значением, умноженным на 10.
• CENTURIES - Возвращает Year с добавленным указанным числом столетий. Эквивалентно вызову plusYears(long) со значением, умноженным на 100.
• MILLENNIA - Возвращает Year с добавленным указанным числом тысячелетий. Эквивалентно вызову plusYears(long) со значением, умноженным на 1000.
• ERAS - Возвращает Year с добавленной указанной эрой. Поддерживается только две эры, поэтому значение должно быть 1, 0 или -1. Если значение не равно нулю, год изменяется так, что год эры не изменяется.

Все другие ChronoUnit экземпляры будут выбрасывать UnsupportedTemporalTypeException.

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

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

public Year plusYears(long yearsToAdd)

Возвращает копию текущего Year с добавлением указанного количества лет.

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

public Year minus(TemporalAmount amountToSubtract)

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

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

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

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

public Year minus(long amountToSubtract,
                  TemporalUnit unit)

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

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

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

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

public Year minusYears(long yearsToSubtract)

Возвращает копию этого Year с указанным количеством лет вычтенным.

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

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

Запрашивает текущий год с использованием указанного запроса.

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

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

public Temporal adjustInto(Temporal temporal)

Настраивает указанный временной объект так, чтобы у него был этот год.

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

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

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

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

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

public long until(Temporal endExclusive,
                  TemporalUnit unit)

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

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

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

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

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

Выбор должен быть сделан на основе того, что делает код более читаемым.

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

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

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

public String format(DateTimeFormatter formatter)

Форматирует текущий год с использованием указанного форматера.

Текущий год будет передан форматеру для получения строки.

public LocalDate atDay(int dayOfYear)

Объединяет текущий год с днем года для создания LocalDate.

Возвращает LocalDate, сформированный из текущего года и указанного дня года.

Значение дня года 366 допустимо только в високосный год.

public YearMonth atMonth(Month month)

Объединяет текущий год с месяцем для создания YearMonth.

Возвращает YearMonth, сформированный из текущего года и указанного месяца. Все возможные комбинации года и месяца допустимы.

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

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

public YearMonth atMonth(int month)

Объединяет текущий год с месяцем, чтобы создать YearMonth.

Возвращает YearMonth, сформированный из текущего года и указанного месяца. Все возможные комбинации года и месяца допустимы.

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

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

public LocalDate atMonthDay(MonthDay monthDay)

Объединяет текущий год с днём месяца, чтобы создать LocalDate.

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

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

public int compareTo(Year other)

Сравнивает текущий год с другим годом.

Сравнение основано на значении года. Оно "совместимо с equals", как определено в Comparable.

public boolean isAfter(Year other)

public boolean isBefore(Year other)

public boolean equals(Object obj)

Проверяет, равен ли текущий год другому году.

Сравнение основано на временной позиции годов.

public int hashCode()

public String toString()