Класс Year

public static final int MIN_VALUE

Минимальный поддерживаемый год, '-999 999 999'.

public static final int MAX_VALUE

Максимальный поддерживаемый год, '+999 999 999'.

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.

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

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

Все остальные экземпляры 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 единицы. Начальная и конечная точки - это текущий год и указанный год. Результат будет отрицательным, если конечная точка находится до начальной. 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()

Выводит этот год как String.