Год (Платформа Java SE 8 b92)

java.lang. Объект
- java.time. Год

Все Реализованные Интерфейсы:

Сериализуемый, Сопоставимый <Год>, Временный, TemporalAccessor, TemporalAdjuster
```
public final class Year
extends Object
implements Temporal, TemporalAdjuster, Comparable<Year>, Serializable
```
Год в календарной системе ISO 8601, такой как 2007.
Year неизменный разовый датой объект, который представляет год. Любое поле, которое может быть получено с года, может быть получено.
Отметьте, что годы в хронологии ISO только выравниваются с годами в Грегорианско-юлианской системе в течение современных лет. Части России не переключались на современные Грегорианские правила / правила ISO до 1920. Также, исторические годы должны быть обработаны с осторожностью.
Этот class не хранит или представляет месяц, день, время или часовой пояс. Например, значение "2007" может быть сохранено в a Year.
Годы, представленные этим class, следуют за стандартом ISO 8601 и используют преждевременную систему нумерации. Году 1 предшествуют за год 0, тогда за год-1.
Календарная система ISO 8601 является современной гражданской календарной системой, используемой сегодня в большей части мира. Это эквивалентно преждевременной системе Григорианского календаря, в которой сегодняшние правила в течение многих високосных годов применяются навсегда. Для большинства приложений, записанных сегодня, правила ISO 8601 являются полностью подходящими. Однако, любое приложение, которое использует исторические даты, и требует, чтобы они были точны, сочтет подход ISO 8601 неподходящим.

Требования реализации:

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

С тех пор:

1.8

См. Также:

Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static int`	`MAX_VALUE` Максимальный поддерживаемый год, '+999 999 999'.
`static int`	`MIN_VALUE` Минимальный поддерживаемый год, '-999 999 999'.

Сводка метода

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`Временный`	`adjustInto(Temporal temporal)` Корректирует указанный временный объект иметь в этом году.
`LocalDate`	`atDay(int dayOfYear)` Объединяется в этом году со днем-летнего, чтобы создать a `LocalDate`.
`YearMonth`	`atMonth(int month)` Объединяется в этом году с месяцем, чтобы создать a `YearMonth`.
`YearMonth`	`atMonth(Month month)` Объединяется в этом году с месяцем, чтобы создать a `YearMonth`.
`LocalDate`	`atMonthDay(MonthDay monthDay)` Объединяется в этом году с дневным месяцем, чтобы создать a `LocalDate`.
`int`	`compareTo(Year other)` Сравнивается в этом году с другим годом.
`boolean`	`equals(Object obj)` Проверки, если этот год равен другому году.
`Строка`	`format(DateTimeFormatter formatter)` Форматы в этом году, используя указанное средство форматирования.
`static Year`	`from(TemporalAccessor temporal)` Получает экземпляр `Year` от временного объекта.
`int`	`get(TemporalField field)` Получает значение указанного поля с этого года как `int`.
`long`	`getLong(TemporalField field)` Получает значение указанного поля с этого года как a `long`.
`int`	`getValue()` Получает значение года.
`int`	`hashCode()` Хэш-код в течение этого года.
`boolean`	`isAfter(Year other)` В этом году после указанного года.
`boolean`	`isBefore(Year other)` В этом году перед указанным годом.
`boolean`	`isLeap()` Проверки, если год является високосным годом согласно ISO преждевременные календарные системные правила.
`static boolean`	`isLeap(long year)` Проверки, если год является високосным годом согласно ISO преждевременные календарные системные правила.
`boolean`	`isSupported(TemporalField field)` Проверки, если указанное поле поддерживается.
`boolean`	`isValidMonthDay(MonthDay monthDay)` Проверки, если дневное месяцем допустимо в течение этого года.
`int`	`length()` Получает продолжительность этого года в днях.
`Год`	`minus(long amountToSubtract, TemporalUnit unit)` Возвращает копию этого года с указанным вычтенным количеством.
`Год`	`minus(TemporalAmount amountToSubtract)` Возвращает копию этого года с указанным вычтенным количеством.
`Год`	`minusYears(long yearsToSubtract)` Возвращает копию этого года с конкретным количеством вычтенных лет.
`static Year`	`now()` Получает текущий год из системных часов в часовом поясе значения по умолчанию.
`static Year`	`now(Clock clock)` Получает текущий год из указанных часов.
`static Year`	`now(ZoneId zone)` Получает текущий год из системных часов в указанном часовом поясе.
`static Year`	`of(int isoYear)` Получает экземпляр `Year`.
`static Year`	`parse(CharSequence text)` Получает экземпляр `Year` от текстовой строки такой как `2007`.
`static Year`	`parse(CharSequence text, DateTimeFormatter formatter)` Получает экземпляр `Year` от текстовой строки, используя определенное средство форматирования.
`long`	`periodUntil(Temporal endYear, TemporalUnit unit)` Вычисляет количество времени до другого года с точки зрения указанного модуля.
`Год`	`plus(long amountToAdd, TemporalUnit unit)` Возвращает копию этого года с указанным добавленным количеством.
`Год`	`plus(TemporalAmount amountToAdd)` Возвращает копию этого года с указанным добавленным количеством.
`Год`	`plusYears(long yearsToAdd)` Возвращает копию этого года с конкретным количеством добавленных лет.
`<R> R`	`query(TemporalQuery<R> query)` Запросы в этом году, используя указанный запрос.
`ValueRange`	`range(TemporalField field)` Получает диапазон допустимых значений для указанного поля.
`Строка`	`toString()` Выводы в этом году как a `String`.
`Год`	`with(TemporalAdjuster adjuster)` Возвращает скорректированную копию этого года.
`Год`	`with(TemporalField field, long newValue)` Возвращает копию этого года с указанным полевым набором к новому значению.

Методы, наследованные от class java.lang. Объект
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, наследованные от интерфейса java.time.temporal. TemporalAdjuster
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame

- Полевая Деталь
  - MIN_VALUE
```
public static final int MIN_VALUE
```
    Минимальный поддерживаемый год, '-999 999 999'.
    
    См. Также:
    
    Постоянные Значения полей
  - MAX_VALUE
```
public static final int MAX_VALUE
```
    Максимальный поддерживаемый год, '+999 999 999'.
    
    См. Также:
    
    Постоянные Значения полей
- Деталь метода
  - теперь
```
public static Year now()
```
    Получает текущий год из системных часов в часовом поясе значения по умолчанию.
    Это запросит system clock в часовом поясе значения по умолчанию, чтобы получить текущий год.
    Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
    
    Возвраты:
    
    текущий год, используя системные часы и часовой пояс значения по умолчанию, не нуль
  - теперь
```
public static Year now(ZoneId zone)
```
    Получает текущий год из системных часов в указанном часовом поясе.
    Это запросит system clock получить текущий год. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
    Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
    
    Параметры:
    
    zone - зональный ID, чтобы использовать, не нуль
    
    Возвраты:
    
    текущий год, используя системные часы, не нуль
  - теперь
```
public static Year now(Clock clock)
```
    Получает текущий год из указанных часов.
    Это запросит указанные часы, чтобы получить текущий год. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection.
    
    Параметры:
    
    clock - часы, чтобы использовать, не нуль
    
    Возвраты:
    
    текущий год, не нуль
  - из
```
public static Year of(int isoYear)
```
    Получает экземпляр Year.
    Этот метод принимает значение года от преждевременной календарной системы ISO.
    Год 2AD/CE представляется 2.
    Год 1AD/CE представляется 1.
    Год 1BC/BCE представляется 0.
    Год 2BC/BCE представляется-1.
    
    Параметры:
    
    isoYear - ISO преждевременный год, чтобы представить, от MIN_VALUE к MAX_VALUE
    
    Возвраты:
    
    год, не нуль
    
    Броски:
    
    DateTimeException - если поле недопустимо
  - от
```
public static Year from(TemporalAccessor temporal)
```
    Получает экземпляр Year от временного объекта.
    Это получает год, основанный на указанном временном. A TemporalAccessor представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр Year.
    Преобразование извлекает year поле. Экстракция только разрешается, если временный объект имеет хронологию ISO, или может быть преобразован в a LocalDate.
    Этот метод соответствует подпись функционального интерфейса TemporalQuery разрешение этого использоваться в запросах через ссылку метода, Year::from.
    
    Параметры:
    
    temporal - временный объект преобразовать, не нуль
    
    Возвраты:
    
    год, не нуль
    
    Броски:
    
    DateTimeException - если неспособный преобразовать в a Year
  - синтаксический анализ
```
public static Year parse(CharSequence text)
```
    Получает экземпляр Year от текстовой строки такой как 2007.
    Строка должна представить допустимый год. Годы вне диапазона 0000 к 9999 должны быть снабжены префиксом плюс или минус символ.
    
    Параметры:
    
    text - текст, чтобы проанализировать такой как "2007", не нуль
    
    Возвраты:
    
    проанализированный год, не нуль
    
    Броски:
    
    DateTimeParseException - если текст не может быть проанализирован
  - синтаксический анализ
```
public static Year parse(CharSequence text,
                         DateTimeFormatter formatter)
```
    Получает экземпляр Year от текстовой строки, используя определенное средство форматирования.
    Текст анализируется, используя средство форматирования, возвращая год.
    
    Параметры:
    
    text - текст, чтобы проанализировать, не нуль
    
    formatter - средство форматирования, чтобы использовать, не нуль
    
    Возвраты:
    
    проанализированный год, не нуль
    
    Броски:
    
    DateTimeParseException - если текст не может быть проанализирован
  - isLeap
```
public static boolean isLeap(long year)
```
    Проверки, если год является високосным годом согласно ISO преждевременные календарные системные правила.
    Этот метод применяет текущие правила в течение многих високосных годов через целую временную шкалу. Вообще, год является високосным годом, если это является делимым четыре без остатка. Однако, годы, делимые 100, не високосные годы, за исключением лет, делимых 400, которые являются.
    Например, 1904 является високосным годом, это является делимым 4. 1900 не был високосным годом, поскольку это является делимым 100, однако 2000 был високосным годом, поскольку это является делимым 400.
    Вычисление является преждевременным - применение тех же самых правил в далекое будущее и далеко мимо. Это исторически неточно, но корректно для стандарта ISO 8601.
    
    Параметры:
    
    year - год, чтобы проверить
    
    Возвраты:
    
    истина, если год является прыжком, ложь иначе
  - getValue
```
public int getValue()
```
    Получает значение года.
    Год, возвращенный этим методом, является преждевременным согласно get(YEAR).
    
    Возвраты:
    
    год, MIN_VALUE к MAX_VALUE
  - isSupported
```
public boolean isSupported(TemporalField field)
```
    Проверки, если указанное поле поддерживается.
    Это проверяет, может ли этот год быть запрошен для указанного поля. Если ложь, то вызов range и get методы выдадут исключение.
    Если поле является a ChronoField тогда запрос реализуется здесь. Поддерживаемые поля:
    - YEAR_OF_ERA
    - YEAR
    - ERA
    Все другой ChronoField экземпляры возвратят false.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.isSupportedBy(TemporalAccessor) передача this как параметр. Поддерживается ли поле, определяется полем.
    Определенный:
    
    isSupported в интерфейсе TemporalAccessor
    
    Параметры:
    
    field - поле, чтобы проверить, обнулите, возвращает false
    
    Возвраты:
    
    истина, если поле поддерживается в этот год, ложь если нет
  - диапазон
```
public ValueRange range(TemporalField field)
```
    Получает диапазон допустимых значений для указанного поля.
    Объект диапазона выражает минимальные и максимальные допустимые значения для поля. Этот год используется, чтобы улучшить точность возвращенного диапазона. Если не возможно возвратить диапазон, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле является a ChronoField тогда запрос реализуется здесь. supported fields возвратит соответствующие экземпляры диапазона. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.rangeRefinedBy(TemporalAccessor) передача this как параметр. Может ли диапазон быть получен, определяется полем.
    
    Определенный:
    
    range в интерфейсе TemporalAccessor
    
    Параметры:
    
    field - поле, чтобы запросить диапазон для, не нуль
    
    Возвраты:
    
    диапазон допустимых значений для поля, не нуль
    
    Броски:
    
    DateTimeException - если диапазон для поля не может быть получен
    
    UnsupportedTemporalTypeException - если поле не поддерживается
  - добраться
```
public int get(TemporalField field)
```
    Получает значение указанного поля с этого года как int.
    Это запрашивает в этом году для значения для указанного поля. Возвращенное значение всегда будет в пределах допустимого диапазона значений для поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле является a ChronoField тогда запрос реализуется здесь. supported fields возвратит допустимые значения, основанные на этом году. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor) передача this как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
    
    Определенный:
    
    get в интерфейсе TemporalAccessor
    
    Параметры:
    
    field - поле, чтобы получить, не нуль
    
    Возвраты:
    
    значение для поля
    
    Броски:
    
    DateTimeException - если значение для поля не может быть получено, или значение вне диапазона допустимых значений для поля
    
    UnsupportedTemporalTypeException - если поле не поддерживается, или диапазон значений превышает int
    
    ArithmeticException - если числовое переполнение происходит
  - getLong
```
public long getLong(TemporalField field)
```
    Получает значение указанного поля с этого года как a long.
    Это запрашивает в этом году для значения для указанного поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле является a ChronoField тогда запрос реализуется здесь. supported fields возвратит допустимые значения, основанные на этом году. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor) передача this как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
    
    Определенный:
    
    getLong в интерфейсе TemporalAccessor
    
    Параметры:
    
    field - поле, чтобы получить, не нуль
    
    Возвраты:
    
    значение для поля
    
    Броски:
    
    DateTimeException - если значение для поля не может быть получено
    
    UnsupportedTemporalTypeException - если поле не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - isLeap
```
public boolean isLeap()
```
    Проверки, если год является високосным годом согласно ISO преждевременные календарные системные правила.
    Этот метод применяет текущие правила в течение многих високосных годов через целую временную шкалу. Вообще, год является високосным годом, если это является делимым четыре без остатка. Однако, годы, делимые 100, не високосные годы, за исключением лет, делимых 400, которые являются.
    Например, 1904 является високосным годом, это является делимым 4. 1900 не был високосным годом, поскольку это является делимым 100, однако 2000 был високосным годом, поскольку это является делимым 400.
    Вычисление является преждевременным - применение тех же самых правил в далекое будущее и далеко мимо. Это исторически неточно, но корректно для стандарта ISO 8601.
    
    Возвраты:
    
    истина, если год является прыжком, ложь иначе
  - isValidMonthDay
```
public boolean isValidMonthDay(MonthDay monthDay)
```
    Проверки, если дневное месяцем допустимо в течение этого года.
    Этот метод проверяет, формируют ли в этом году и входной месяц и день допустимую дату.
    
    Параметры:
    
    monthDay - дневное месяцем, чтобы проверить, обнулите, возвращает false
    
    Возвраты:
    
    истина, если месяц и день допустимы в течение этого года
  - длина
```
public int length()
```
    Получает продолжительность этого года в днях.
    
    Возвраты:
    
    продолжительность этого года в днях, 365 или 366
  - с
```
public Year with(TemporalAdjuster adjuster)
```
    Возвращает скорректированную копию этого года.
    Это возвращает a Year, основанный на этом, со скорректированным годом. Корректировка имеет место, используя указанный объект стратегии регулятора. Считайте документацию регулятора, чтобы понять, какая корректировка будет внесена.
    Результат этого метода получается, вызывая TemporalAdjuster.adjustInto(Temporal) метод на указанной передаче регулятора this как параметр.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Определенный:
    
    with в интерфейсе Temporal
    
    Параметры:
    
    adjuster - регулятор, чтобы использовать, не нуль
    
    Возвраты:
    
    a Year основанный на this с внесенной корректировкой, не нуль
    
    Броски:
    
    DateTimeException - если корректировка не может быть внесена
    
    ArithmeticException - если числовое переполнение происходит
  - с
```
public Year with(TemporalField field,
                 long newValue)
```
    Возвращает копию этого года с указанным полевым набором к новому значению.
    Это возвращает a Year, основанный на этом, со значением для указанного поля изменился. Если не возможно установить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле является a ChronoField тогда корректировка реализуется здесь. Поддерживаемые поля ведут себя следующим образом:
    - YEAR_OF_ERA - Возвраты a Year с указанным годом эры эра будет неизменна.
    - YEAR - Возвраты a Year с указанным годом. Это полностью заменяет дату и эквивалентно of(int).
    - ERA - Возвраты a Year с указанной эрой. Год эры будет неизменен.
    Во всех случаях, если новое значение вне допустимого диапазона значений для поля тогда a DateTimeException будет брошен.
    Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.adjustInto(Temporal, long) передача this как параметр. В этом случае поле определяет, ли и как скорректировать момент.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    with в интерфейсе Temporal
    
    Параметры:
    
    field - поле, чтобы установить в результате, не нуле
    
    newValue - новое значение поля в результате
    
    Возвраты:
    
    a Year основанный на this с указанным полевым набором, не нулем
    
    Броски:
    
    DateTimeException - если поле не может быть установлено
    
    UnsupportedTemporalTypeException - если поле не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - плюс
```
public Year plus(TemporalAmount amountToAdd)
```
    Возвращает копию этого года с указанным добавленным количеством.
    Это возвращает a Year, основанный на этом, с указанным добавленным количеством. Количество обычно Period но может быть любой другой тип, реализовывая TemporalAmount интерфейс.
    Вычисление делегируется к объекту количества, вызывая TemporalAmount.addTo(Temporal). Реализация количества свободна реализовать дополнение всегда, это желает, однако это обычно перезванивает к plus(long, TemporalUnit). Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно добавлено.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Определенный:
    
    plus в интерфейсе Temporal
    
    Параметры:
    
    amountToAdd - количество, чтобы добавить, не нуль
    
    Возвраты:
    
    a Year основанный на этом году со сделанным дополнением, не нуль
    
    Броски:
    
    DateTimeException - если дополнение не может быть сделано
    
    ArithmeticException - если числовое переполнение происходит
  - плюс
```
public Year plus(long amountToAdd,
                 TemporalUnit unit)
```
    Возвращает копию этого года с указанным добавленным количеством.
    Это возвращает a Year, основанный на этом, с количеством с точки зрения модуля добавил. Если не возможно добавить количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле является a ChronoUnit тогда дополнение реализуется здесь. Поддерживаемые поля ведут себя следующим образом:
    - YEARS - Возвраты a Year с конкретным количеством добавленных лет. Это эквивалентно plusYears(long).
    - DECADES - Возвраты a Year с конкретным количеством добавленных десятилетий. Это эквивалентно вызову plusYears(long) с количеством, умноженным на 10.
    - CENTURIES - Возвраты a Year с конкретным количеством добавленных столетий. Это эквивалентно вызову plusYears(long) с количеством, умноженным на 100.
    - MILLENNIA - Возвраты a Year с конкретным количеством добавленных тысячелетий. Это эквивалентно вызову plusYears(long) с количеством, умноженным на 1 000.
    - ERAS - Возвраты a Year с конкретным количеством добавленных эр. Только две эры поддерживаются так, количество должно быть один, нуль или минус один. Если количество является ненулевым тогда, год изменяется так, что, год эры неизменен.
    Все другой ChronoUnit экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoUnit, тогда результат этого метода получается, вызывая TemporalUnit.addTo(Temporal, long) передача this как параметр. В этом случае модуль определяет, ли и как выполнить дополнение.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    plus в интерфейсе Temporal
    
    Параметры:
    
    amountToAdd - количество модуля, чтобы добавить к результату, может быть отрицательным
    
    unit - модуль количества, чтобы добавить, не нуль
    
    Возвраты:
    
    a Year основанный на этом году с указанным количеством добавил, не нуль
    
    Броски:
    
    DateTimeException - если дополнение не может быть сделано
    
    UnsupportedTemporalTypeException - если модуль не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - plusYears
```
public Year plusYears(long yearsToAdd)
```
    Возвращает копию этого года с конкретным количеством добавленных лет.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    yearsToAdd - годы, чтобы добавить, может быть отрицательным
    
    Возвраты:
    
    a Year основанный на этом году с периодом добавил, не нуль
    
    Броски:
    
    DateTimeException - если результат превышает поддерживаемый диапазон года
  - минус
```
public Year minus(TemporalAmount amountToSubtract)
```
    Возвращает копию этого года с указанным вычтенным количеством.
    Это возвращает a Year, основанный на этом, с указанным вычтенным количеством. Количество обычно Period но может быть любой другой тип, реализовывая TemporalAmount интерфейс.
    Вычисление делегируется к объекту количества, вызывая TemporalAmount.subtractFrom(Temporal). Реализация количества свободна реализовать вычитание всегда, это желает, однако это обычно перезванивает к minus(long, TemporalUnit). Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно вычтено.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Определенный:
    
    minus в интерфейсе Temporal
    
    Параметры:
    
    amountToSubtract - количество, чтобы вычесть, не нуль
    
    Возвраты:
    
    a Year основанный на этом году со сделанным вычитанием, не нуль
    
    Броски:
    
    DateTimeException - если вычитание не может быть сделано
    
    ArithmeticException - если числовое переполнение происходит
  - минус
```
public Year minus(long amountToSubtract,
                  TemporalUnit unit)
```
    Возвращает копию этого года с указанным вычтенным количеством.
    Это возвращает a Year, основанный на этом, с количеством с точки зрения модуля вычитается. Если не возможно вычесть количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
    Этот метод эквивалентен plus(long, TemporalUnit) с отрицаемым количеством. См., что метод для полного описания того, как дополнение, и таким образом вычитание, работают.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Определенный:
    
    minus в интерфейсе Temporal
    
    Параметры:
    
    amountToSubtract - количество модуля, чтобы вычесть из результата, может быть отрицательным
    
    unit - модуль количества, чтобы вычесть, не нуль
    
    Возвраты:
    
    a Year основанный на этом году с указанным вычтенным количеством, не нуль
    
    Броски:
    
    DateTimeException - если вычитание не может быть сделано
    
    UnsupportedTemporalTypeException - если модуль не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - minusYears
```
public Year minusYears(long yearsToSubtract)
```
    Возвращает копию этого года с конкретным количеством вычтенных лет.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    yearsToSubtract - годы, чтобы вычесть, может быть отрицательным
    
    Возвраты:
    
    a Year основанный на этом году с вычтенным периодом, не нуль
    
    Броски:
    
    DateTimeException - если результат превышает поддерживаемый диапазон года
  - запрос
```
public <R> R query(TemporalQuery<R> query)
```
    Запросы в этом году, используя указанный запрос.
    Это запрашивает в этом году, используя указанный объект стратегии запроса. TemporalQuery объект определяет логику, которая будет использоваться, чтобы получить результат. Считайте документацию запроса, чтобы понять, каков результат этого метода будет.
    Результат этого метода получается, вызывая TemporalQuery.queryFrom(TemporalAccessor) метод на указанной передаче запроса this как параметр.
    
    Определенный:
    
    query в интерфейсе TemporalAccessor
    
    Введите Параметры:
    
    R - тип результата
    
    Параметры:
    
    query - запрос, чтобы вызвать, не нуль
    
    Возвраты:
    
    результат запроса, нуль может быть возвращен (определенный запросом)
    
    Броски:
    
    DateTimeException - если неспособный запрашивать (определенный запросом)
    
    ArithmeticException - если числовое переполнение происходит (определенный запросом)
  - adjustInto
```
public Temporal adjustInto(Temporal temporal)
```
    Корректирует указанный временный объект иметь в этом году.
    Это возвращает временный объект того же самого заметного типа как ввод с годом, измененным, чтобы быть тем же самым как этим.
    Корректировка эквивалентна использованию Temporal.with(TemporalField, long) передача ChronoField.YEAR как поле. Если указанный временный объект не использует календарную систему ISO тогда a DateTimeException бросается.
    В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.with(TemporalAdjuster):
```
   // these two lines are equivalent, but the second approach is recommended
   temporal = thisYear.adjustInto(temporal);
   temporal = temporal.with(thisYear);
 
```
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    adjustInto в интерфейсе TemporalAdjuster
    
    Параметры:
    
    temporal - целевой объект, который будет скорректирован, не нуль
    
    Возвраты:
    
    скорректированный объект, не нуль
    
    Броски:
    
    DateTimeException - если неспособный вносить корректировку
    
    ArithmeticException - если числовое переполнение происходит
  - periodUntil
```
public long periodUntil(Temporal endYear,
                        TemporalUnit unit)
```
    Вычисляет количество времени до другого года с точки зрения указанного модуля.
    Это вычисляет количество времени между два Year объекты с точки зрения сингла TemporalUnit. Запуск и конечные точки this и указанный год. Результат будет отрицателен, если конец будет перед запуском. Temporal переданный к этому методу должен быть a Year. Например, период в десятилетиях между двухлетним может быть вычислен, используя startYear.periodUntil(endYear, DECADES).
    Вычисление возвращает целое число, представляя число полных модулей между этими двумя годами. Например, период в десятилетиях между 2012 и 2031 только будет одним десятилетием, поскольку это - один год за исключением двух десятилетий.
    Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод. Второе должно использовать TemporalUnit.between(Temporal, Temporal):
```
   // these two lines are equivalent
   amount = start.periodUntil(end, YEARS);
   amount = YEARS.between(start, end);
 
```
    Выбор должен быть сделан основанный, которого делает код более читаемым.
    Вычисление реализуется в этом методе для ChronoUnit. Модули YEARS, DECADES, CENTURIES, MILLENNIA и ERAS поддерживаются. Другой ChronoUnit значения выдадут исключение.
    Если модуль не является a ChronoUnit, тогда результат этого метода получается, вызывая TemporalUnit.between(Temporal, Temporal) передача this как первый параметр и ввод, временный как второй параметр.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    periodUntil в интерфейсе Temporal
    
    Параметры:
    
    endYear - год конца, который должен быть a Year, не нуль
    
    unit - модуль, чтобы измерить количество в, не нуль
    
    Возвраты:
    
    количество времени между этим годом и годом конца
    
    Броски:
    
    DateTimeException - если количество не может быть вычислено
    
    UnsupportedTemporalTypeException - если модуль не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - формат
```
public String format(DateTimeFormatter formatter)
```
    Форматы в этом году, используя указанное средство форматирования.
    Этот год передадут к средству форматирования, чтобы произвести строку.
    
    Параметры:
    
    formatter - средство форматирования, чтобы использовать, не нуль
    
    Возвраты:
    
    отформатированная строка года, не нуль
    
    Броски:
    
    DateTimeException - если ошибка происходит во время печати
  - atDay
```
public LocalDate atDay(int dayOfYear)
```
    Объединяется в этом году со днем-летнего, чтобы создать a LocalDate.
    Это возвращает a LocalDate сформированный с этого года и указанного дня-летнего.
    В високосный год дневное-летнего значение 366 только допустимо.
    
    Параметры:
    
    dayOfYear - день-летнего, чтобы использовать, не нуль
    
    Возвраты:
    
    локальная дата, сформированная с этого года и указанной даты года, не нуля
    
    Броски:
    
    DateTimeException - если день года является нулем или меньше, 366 или больше или равный 366, и это не високосный год
  - atMonth
```
public YearMonth atMonth(Month month)
```
    Объединяется в этом году с месяцем, чтобы создать a YearMonth.
    Это возвращает a YearMonth сформированный с этого года и указанного месяца. Все возможные комбинации года и месяца допустимы.
    Этот метод может использоваться в качестве части цепочки, чтобы произвести дату:
```
  LocalDate date = year.atMonth(month).atDay(day);
 
```
    Параметры:
    
    month - месяц-летнего, чтобы использовать, не нуль
    
    Возвраты:
    
    месячное годом, сформированное с этого года и указанного месяца, не нуля
  - atMonth
```
public YearMonth atMonth(int month)
```
    Объединяется в этом году с месяцем, чтобы создать a YearMonth.
    Это возвращает a YearMonth сформированный с этого года и указанного месяца. Все возможные комбинации года и месяца допустимы.
    Этот метод может использоваться в качестве части цепочки, чтобы произвести дату:
```
  LocalDate date = year.atMonth(month).atDay(day);
 
```
    Параметры:
    
    month - месяц-летнего, чтобы использовать, от 1 (январь) к 12 (декабрь)
    
    Возвраты:
    
    месячное годом, сформированное с этого года и указанного месяца, не нуля
    
    Броски:
    
    DateTimeException - если месяц недопустим
  - atMonthDay
```
public LocalDate atMonthDay(MonthDay monthDay)
```
    Объединяется в этом году с дневным месяцем, чтобы создать a LocalDate.
    Это возвращает a LocalDate сформированный с этого года и указанного дневного месяцем.
    Дневное месяцем от 29-ого февраля будет скорректировано до 28-ого февраля в получающейся дате, если год не будет високосным годом.
    
    Параметры:
    
    monthDay - дневное месяцем, чтобы использовать, не нуль
    
    Возвраты:
    
    локальная дата, сформированная с этого года и указанного дневного месяцем, не нулевого
  - compareTo
```
public int compareTo(Year other)
```
    Сравнивается в этом году с другим годом.
    Сравнение основано на значении года. Это является "непротиворечивым с, равняется", как определено Comparable.
    
    Определенный:
    
    compareTo в интерфейсе Comparable<Year>
    
    Параметры:
    
    other - другой год, чтобы сравнить с, не нуль
    
    Возвраты:
    
    значение компаратора, отрицательное, если меньше, положительный если больше
  - isAfter
```
public boolean isAfter(Year other)
```
    В этом году после указанного года.
    
    Параметры:
    
    other - другой год, чтобы сравнить с, не нуль
    
    Возвраты:
    
    истина, если это после указанного года
  - isBefore
```
public boolean isBefore(Year other)
```
    В этом году перед указанным годом.
    
    Параметры:
    
    other - другой год, чтобы сравнить с, не нуль
    
    Возвраты:
    
    истина, если эта точка перед указанным годом
  - равняется
```
public boolean equals(Object obj)
```
    Проверки, если этот год равен другому году.
    Сравнение основано на позиции временной шкалы лет.
    
    Переопределения:
    
    equals в class Object
    
    Параметры:
    
    obj - объект проверить, обнулите, возвращает false
    
    Возвраты:
    
    истина, если это равно другому году
    
    См. Также:
    
    Object.hashCode(), HashMap
  - хэш-код
```
public int hashCode()
```
    Хэш-код в течение этого года.
    
    Переопределения:
    
    hashCode в class Object
    
    Возвраты:
    
    подходящий хэш-код
    
    См. Также:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    Выводы в этом году как a String.
    
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    строковое представление этого года, не нуль

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Год класса

Полевая Сводка

Сводка метода

Методы, наследованные от class java.lang. Объект

Методы, наследованные от интерфейса java.time.temporal. TemporalAdjuster

Полевая Деталь

MIN_VALUE

MAX_VALUE

Деталь метода

теперь

теперь

теперь

из

от

синтаксический анализ

синтаксический анализ

isLeap

getValue

isSupported

диапазон

добраться

getLong

isLeap

isValidMonthDay

длина

с

с

плюс

плюс

plusYears

минус

минус

minusYears

запрос

adjustInto

periodUntil

формат

atDay

atMonth

atMonth

atMonthDay

compareTo

isAfter

isBefore

равняется

хэш-код

toString