Класс 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 AD/CE представлен как 2.
Год 1 AD/CE представлен как 1.
Год 1 BC/BCE представлен как 0.
Год 2 BC/BCE представлен как -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)

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

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

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

• YEAR_OF_ERA
• YEAR
• ERA

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

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

public boolean isSupported(TemporalUnit unit)

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

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

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

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

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

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

public Year plus(long amountToAdd, TemporalUnit unit)

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

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

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

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

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

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

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

public Year plusYears(long yearsToAdd)

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

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

public Year minus(TemporalAmount amountToSubtract)

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

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

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

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

public Year minus(long amountToSubtract, TemporalUnit unit)

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

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

Этот метод эквивалентен 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()

Выводит текущий год в виде String.