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

java.lang. Объект
- java.time. YearMonth

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

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

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

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

С тех пор:

1.8

См. Также:

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

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

Все Методы Статические Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`Временный`	`adjustInto(Temporal temporal)` Корректирует указанный временный объект иметь это месячное годом.
`LocalDate`	`atDay(int dayOfMonth)` Комбинирует это месячное годом со днем-месячного, чтобы создать a `LocalDate`.
`LocalDate`	`atEndOfMonth()` Возвраты a `LocalDate` в конце месяца.
`int`	`compareTo(YearMonth other)` Сравнивает это месячное годом с другим месячным годом.
`boolean`	`equals(Object obj)` Проверки, если это месячное годом равно другому месячному годом.
`Строка`	`format(DateTimeFormatter formatter)` Форматы это месячное годом использование указанного средства форматирования.
`static YearMonth`	`from(TemporalAccessor temporal)` Получает экземпляр `YearMonth` от временного объекта.
`int`	`get(TemporalField field)` Получает значение указанного поля от этого месячного годом как `int`.
`long`	`getLong(TemporalField field)` Получает значение указанного поля от этого месячного годом как a `long`.
`Месяц`	`getMonth()` Получает поле месяца-летнего, используя `Month` перечисление.
`int`	`getMonthValue()` Получает поле месяца-летнего от 1 до 12.
`int`	`getYear()` Получает поле года.
`int`	`hashCode()` Хэш-код для этого месячного годом.
`boolean`	`isAfter(YearMonth other)` Это месячное годом после указанного месячного годом.
`boolean`	`isBefore(YearMonth other)` Это месячное годом перед указанным месячным годом.
`boolean`	`isLeapYear()` Проверки, если год является високосным годом согласно ISO преждевременные календарные системные правила.
`boolean`	`isSupported(TemporalField field)` Проверки, если указанное поле поддерживается.
`boolean`	`isValidDay(int dayOfMonth)` Проверки, если день-месячного допустим для этого месячного годом.
`int`	`lengthOfMonth()` Возвращает продолжительность месяца, принимая во внимание год.
`int`	`lengthOfYear()` Возвращает продолжительность года.
`YearMonth`	`minus(long amountToSubtract, TemporalUnit unit)` Возвращает копию этого месячного годом с указанным вычтенным количеством.
`YearMonth`	`minus(TemporalAmount amountToSubtract)` Возвращает копию этого месячного годом с указанным вычтенным количеством.
`YearMonth`	`minusMonths(long monthsToSubtract)` Возвращает копию этого месячного годом с установленным периодом в вычтенных месяцах.
`YearMonth`	`minusYears(long yearsToSubtract)` Возвращает копию этого месячного годом с установленным периодом в вычтенных годах.
`static YearMonth`	`now()` Получает ток, месячный годом из системных часов в часовом поясе значения по умолчанию.
`static YearMonth`	`now(Clock clock)` Получает ток, месячный годом из указанных часов.
`static YearMonth`	`now(ZoneId zone)` Получает ток, месячный годом из системных часов в указанном часовом поясе.
`static YearMonth`	`of(int year, int month)` Получает экземпляр `YearMonth` с года и месяца.
`static YearMonth`	`of(int year, Month month)` Получает экземпляр `YearMonth` с года и месяца.
`static YearMonth`	`parse(CharSequence text)` Получает экземпляр `YearMonth` от текстовой строки такой как `2007-12`.
`static YearMonth`	`parse(CharSequence text, DateTimeFormatter formatter)` Получает экземпляр `YearMonth` от текстовой строки, используя определенное средство форматирования.
`long`	`periodUntil(Temporal endYearMonth, TemporalUnit unit)` Вычисляет количество времени до другого месячного годом с точки зрения указанного модуля.
`YearMonth`	`plus(long amountToAdd, TemporalUnit unit)` Возвращает копию этого месячного годом с указанным добавленным количеством.
`YearMonth`	`plus(TemporalAmount amountToAdd)` Возвращает копию этого месячного годом с указанным добавленным количеством.
`YearMonth`	`plusMonths(long monthsToAdd)` Возвращает копию этого месячного годом с установленным периодом в добавленных месяцах.
`YearMonth`	`plusYears(long yearsToAdd)` Возвращает копию этого месячного годом с установленным периодом в добавленных годах.
`<R> R`	`query(TemporalQuery<R> query)` Запросы это месячное годом использование указанного запроса.
`ValueRange`	`range(TemporalField field)` Получает диапазон допустимых значений для указанного поля.
`Строка`	`toString()` Выводит это месячное годом как a `String`, такой как `2007-12`.
`YearMonth`	`with(TemporalAdjuster adjuster)` Возвращает скорректированную копию этого месячного годом.
`YearMonth`	`with(TemporalField field, long newValue)` Возвращает копию этого месячного годом с указанным полевым набором к новому значению.
`YearMonth`	`withMonth(int month)` Возвращает копию этого `YearMonth` с измененным месяцем-летнего.
`YearMonth`	`withYear(int year)` Возвращает копию этого `YearMonth` с измененным годом.

Методы, наследованные от 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

- Деталь метода
  - теперь
```
public static YearMonth now()
```
    Получает ток, месячный годом из системных часов в часовом поясе значения по умолчанию.
    Это запросит system clock в часовом поясе значения по умолчанию, чтобы получить месячный годом ток. Зона и смещение будут установлены основанные на часовом поясе в часах.
    Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
    
    Возвраты:
    
    текущее месячное годом использование системных часов и часового пояса значения по умолчанию, не нуля
  - теперь
```
public static YearMonth now(ZoneId zone)
```
    Получает ток, месячный годом из системных часов в указанном часовом поясе.
    Это запросит system clock получить месячный годом ток. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
    Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
    
    Параметры:
    
    zone - зональный ID, чтобы использовать, не нуль
    
    Возвраты:
    
    текущее месячное годом использование системных часов, не нуля
  - теперь
```
public static YearMonth now(Clock clock)
```
    Получает ток, месячный годом из указанных часов.
    Это запросит указанные часы, чтобы получить месячный годом ток. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection.
    
    Параметры:
    
    clock - часы, чтобы использовать, не нуль
    
    Возвраты:
    
    месячный годом ток, не нулевой
  - из
```
public static YearMonth of(int year,
                           Month month)
```
    Получает экземпляр YearMonth с года и месяца.
    
    Параметры:
    
    year - год, чтобы представить, от MIN_YEAR до MAX_YEAR
    
    month - месяц-летнего, чтобы представить, не нуль
    
    Возвраты:
    
    месячное годом, не нулевое
    
    Броски:
    
    DateTimeException - если значение года недопустимо
  - из
```
public static YearMonth of(int year,
                           int month)
```
    Получает экземпляр YearMonth с года и месяца.
    
    Параметры:
    
    year - год, чтобы представить, от MIN_YEAR до MAX_YEAR
    
    month - месяц-летнего, чтобы представить, от 1 (январь) к 12 (декабрь)
    
    Возвраты:
    
    месячное годом, не нулевое
    
    Броски:
    
    DateTimeException - если любое значение поля недопустимо
  - от
```
public static YearMonth from(TemporalAccessor temporal)
```
    Получает экземпляр YearMonth от временного объекта.
    Это получает месячное годом основанное на указанном временном. A TemporalAccessor представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр YearMonth.
    Преобразование извлекает YEAR и MONTH_OF_YEAR поля. Экстракция только разрешается, если временный объект имеет хронологию ISO, или может быть преобразован в a LocalDate.
    Этот метод соответствует подпись функционального интерфейса TemporalQuery разрешение этого использоваться в запросах через ссылку метода, YearMonth::from.
    
    Параметры:
    
    temporal - временный объект преобразовать, не нуль
    
    Возвраты:
    
    месячное годом, не нулевое
    
    Броски:
    
    DateTimeException - если неспособный преобразовать в a YearMonth
  - синтаксический анализ
```
public static YearMonth parse(CharSequence text)
```
    Получает экземпляр YearMonth от текстовой строки такой как 2007-12.
    Строка должна представить допустимое месячное годом. Формат должен быть uuuu-MM. Годы вне диапазона 0000 к 9999 должны быть снабжены префиксом плюс или минус символ.
    
    Параметры:
    
    text - текст, чтобы проанализировать такой как "2007-12", не нуль
    
    Возвраты:
    
    проанализированное месячное годом, не нулевое
    
    Броски:
    
    DateTimeParseException - если текст не может быть проанализирован
  - синтаксический анализ
```
public static YearMonth parse(CharSequence text,
                              DateTimeFormatter formatter)
```
    Получает экземпляр YearMonth от текстовой строки, используя определенное средство форматирования.
    Текст анализируется, используя средство форматирования, возвращая месячное годом.
    
    Параметры:
    
    text - текст, чтобы проанализировать, не нуль
    
    formatter - средство форматирования, чтобы использовать, не нуль
    
    Возвраты:
    
    проанализированное месячное годом, не нулевое
    
    Броски:
    
    DateTimeParseException - если текст не может быть проанализирован
  - isSupported
```
public boolean isSupported(TemporalField field)
```
    Проверки, если указанное поле поддерживается.
    Это проверяет, может ли это месячное годом быть запрошено для указанного поля. Если ложь, то вызов range и get методы выдадут исключение.
    Если поле является a ChronoField тогда запрос реализуется здесь. Поддерживаемые поля:
    - MONTH_OF_YEAR
    - PROLEPTIC_MONTH
    - 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 возвратит допустимые значения, основанные на этом месячном годом, кроме PROLEPTIC_MONTH который является слишком большим, чтобы вписаться int и бросок a DateTimeException. Все другой 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 - если числовое переполнение происходит
  - getYear
```
public int getYear()
```
    Получает поле года.
    Этот метод возвращает примитив int значение в течение года.
    Год, возвращенный этим методом, является преждевременным согласно get(YEAR).
    
    Возвраты:
    
    год, от MIN_YEAR до MAX_YEAR
  - getMonthValue
```
public int getMonthValue()
```
    Получает поле месяца-летнего от 1 до 12.
    Этот метод возвращает месяц как int от 1 до 12. Код программы является часто более четким если перечисление Month используется, вызывая getMonth().
    
    Возвраты:
    
    месяц-летнего, от 1 до 12
    
    См. Также:
    
    getMonth()
  - getMonth
```
public Month getMonth()
```
    Получает поле месяца-летнего, используя Month перечисление.
    Этот метод возвращает перечисление Month в течение месяца. Это избегает беспорядка относительно какой int среднее значение значений. Если Вы нуждаетесь в доступе к примитиву int значение тогда перечисление обеспечивает int value.
    
    Возвраты:
    
    месяц-летнего, не нуль
    
    См. Также:
    
    getMonthValue()
  - isLeapYear
```
public boolean isLeapYear()
```
    Проверки, если год является високосным годом согласно ISO преждевременные календарные системные правила.
    Этот метод применяет текущие правила в течение многих високосных годов через целую временную шкалу. Вообще, год является високосным годом, если это является делимым четыре без остатка. Однако, годы, делимые 100, не високосные годы, за исключением лет, делимых 400, которые являются.
    Например, 1904 является високосным годом, это является делимым 4. 1900 не был високосным годом, поскольку это является делимым 100, однако 2000 был високосным годом, поскольку это является делимым 400.
    Вычисление является преждевременным - применение тех же самых правил в далекое будущее и далеко мимо. Это исторически неточно, но корректно для стандарта ISO 8601.
    
    Возвраты:
    
    истина, если год является прыжком, ложь иначе
  - isValidDay
```
public boolean isValidDay(int dayOfMonth)
```
    Проверки, если день-месячного допустим для этого месячного годом.
    Этот метод проверяет, формируют ли в этом году и месяц и входной день допустимую дату.
    
    Параметры:
    
    dayOfMonth - день-месячного, чтобы проверить, от 1 до 31, недопустимое значение возвращает false
    
    Возвраты:
    
    истина, если день допустим для этого месячного годом
  - lengthOfMonth
```
public int lengthOfMonth()
```
    Возвращает продолжительность месяца, принимая во внимание год.
    Это возвращает продолжительность месяца в днях. Например, дата в январе возвратилась бы 31.
    
    Возвраты:
    
    продолжительность месяца в днях, от 28 до 31
  - lengthOfYear
```
public int lengthOfYear()
```
    Возвращает продолжительность года.
    Это возвращает продолжительность года в днях, или 365 или 366.
    
    Возвраты:
    
    366, если год является прыжком, 365 иначе
  - с
```
public YearMonth with(TemporalAdjuster adjuster)
```
    Возвращает скорректированную копию этого месячного годом.
    Это возвращает a YearMonth, основанный на этом, со скорректированным месячным годом. Корректировка имеет место, используя указанный объект стратегии регулятора. Считайте документацию регулятора, чтобы понять, какая корректировка будет внесена.
    Простой регулятор мог бы просто установить то из полей, таких как поле года. Более сложный регулятор мог бы установить месячное годом в следующий месяц, что комета Халли передаст Землю.
    Результат этого метода получается, вызывая TemporalAdjuster.adjustInto(Temporal) метод на указанной передаче регулятора this как параметр.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Определенный:
    
    with в интерфейсе Temporal
    
    Параметры:
    
    adjuster - регулятор, чтобы использовать, не нуль
    
    Возвраты:
    
    a YearMonth основанный на this с внесенной корректировкой, не нуль
    
    Броски:
    
    DateTimeException - если корректировка не может быть внесена
    
    ArithmeticException - если числовое переполнение происходит
  - с
```
public YearMonth with(TemporalField field,
                      long newValue)
```
    Возвращает копию этого месячного годом с указанным полевым набором к новому значению.
    Это возвращает a YearMonth, основанный на этом, со значением для указанного поля изменился. Это может использоваться, чтобы изменить любое поддерживаемое поле, такое как год или месяц. Если не возможно установить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле является a ChronoField тогда корректировка реализуется здесь. Поддерживаемые поля ведут себя следующим образом:
    - MONTH_OF_YEAR - Возвраты a YearMonth с указанным месяцем-летнего. Год будет неизменен.
    - PROLEPTIC_MONTH - Возвраты a YearMonth с указанным преждевременно-месячным. Это полностью заменяет год и месяц этого объекта.
    - YEAR_OF_ERA - Возвраты a YearMonth с указанным годом эры месяц и эра будут неизменны.
    - YEAR - Возвраты a YearMonth с указанным годом. Месяц будет неизменен.
    - ERA - Возвраты a YearMonth с указанной эрой. Месяц и год эры будут неизменны.
    Во всех случаях, если новое значение вне допустимого диапазона значений для поля тогда a DateTimeException будет брошен.
    Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.adjustInto(Temporal, long) передача this как параметр. В этом случае поле определяет, ли и как скорректировать момент.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    with в интерфейсе Temporal
    
    Параметры:
    
    field - поле, чтобы установить в результате, не нуле
    
    newValue - новое значение поля в результате
    
    Возвраты:
    
    a YearMonth основанный на this с указанным полевым набором, не нулем
    
    Броски:
    
    DateTimeException - если поле не может быть установлено
    
    UnsupportedTemporalTypeException - если поле не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - withYear
```
public YearMonth withYear(int year)
```
    Возвращает копию этого YearMonth с измененным годом.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    year - год, чтобы установить в возвращенном месячном годом, от MIN_YEAR до MAX_YEAR
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом с требуемым годом, не нулем
    
    Броски:
    
    DateTimeException - если значение года недопустимо
  - withMonth
```
public YearMonth withMonth(int month)
```
    Возвращает копию этого YearMonth с измененным месяцем-летнего.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    month - месяц-летнего, чтобы установить в возвращенном месячном годом, от 1 (январь) к 12 (декабрь)
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом с требуемым месяцем, не нулем
    
    Броски:
    
    DateTimeException - если значение месяца-летнего недопустимо
  - плюс
```
public YearMonth plus(TemporalAmount amountToAdd)
```
    Возвращает копию этого месячного годом с указанным добавленным количеством.
    Это возвращает a YearMonth, основанный на этом, с указанным добавленным количеством. Количество обычно Period но может быть любой другой тип, реализовывая TemporalAmount интерфейс.
    Вычисление делегируется к объекту количества, вызывая TemporalAmount.addTo(Temporal). Реализация количества свободна реализовать дополнение всегда, это желает, однако это обычно перезванивает к plus(long, TemporalUnit). Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно добавлено.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Определенный:
    
    plus в интерфейсе Temporal
    
    Параметры:
    
    amountToAdd - количество, чтобы добавить, не нуль
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом со сделанным дополнением, не нуль
    
    Броски:
    
    DateTimeException - если дополнение не может быть сделано
    
    ArithmeticException - если числовое переполнение происходит
  - плюс
```
public YearMonth plus(long amountToAdd,
                      TemporalUnit unit)
```
    Возвращает копию этого месячного годом с указанным добавленным количеством.
    Это возвращает a YearMonth, основанный на этом, с количеством с точки зрения модуля добавил. Если не возможно добавить количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
    Если поле является a ChronoUnit тогда дополнение реализуется здесь. Поддерживаемые поля ведут себя следующим образом:
    - MONTHS - Возвраты a YearMonth с конкретным количеством добавленных месяцев. Это эквивалентно plusMonths(long).
    - YEARS - Возвраты a YearMonth с конкретным количеством добавленных лет. Это эквивалентно plusYears(long).
    - DECADES - Возвраты a YearMonth с конкретным количеством добавленных десятилетий. Это эквивалентно вызову plusYears(long) с количеством, умноженным на 10.
    - CENTURIES - Возвраты a YearMonth с конкретным количеством добавленных столетий. Это эквивалентно вызову plusYears(long) с количеством, умноженным на 100.
    - MILLENNIA - Возвраты a YearMonth с конкретным количеством добавленных тысячелетий. Это эквивалентно вызову plusYears(long) с количеством, умноженным на 1 000.
    - ERAS - Возвраты a YearMonth с конкретным количеством добавленных эр. Только две эры поддерживаются так, количество должно быть один, нуль или минус один. Если количество является ненулевым тогда, год изменяется так, что, год эры неизменен.
    Все другой ChronoUnit экземпляры бросят UnsupportedTemporalTypeException.
    Если поле не является a ChronoUnit, тогда результат этого метода получается, вызывая TemporalUnit.addTo(Temporal, long) передача this как параметр. В этом случае модуль определяет, ли и как выполнить дополнение.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    plus в интерфейсе Temporal
    
    Параметры:
    
    amountToAdd - количество модуля, чтобы добавить к результату, может быть отрицательным
    
    unit - модуль количества, чтобы добавить, не нуль
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом с указанным количеством добавил, не нуль
    
    Броски:
    
    DateTimeException - если дополнение не может быть сделано
    
    UnsupportedTemporalTypeException - если модуль не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - plusYears
```
public YearMonth plusYears(long yearsToAdd)
```
    Возвращает копию этого месячного годом с установленным периодом в добавленных годах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    yearsToAdd - годы, чтобы добавить, может быть отрицательным
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом с годами добавил, не нуль
    
    Броски:
    
    DateTimeException - если результат превышает поддерживаемый диапазон
  - plusMonths
```
public YearMonth plusMonths(long monthsToAdd)
```
    Возвращает копию этого месячного годом с установленным периодом в добавленных месяцах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    monthsToAdd - месяцы, чтобы добавить, может быть отрицательным
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом с месяцами добавил, не нуль
    
    Броски:
    
    DateTimeException - если результат превышает поддерживаемый диапазон
  - минус
```
public YearMonth minus(TemporalAmount amountToSubtract)
```
    Возвращает копию этого месячного годом с указанным вычтенным количеством.
    Это возвращает a YearMonth, основанный на этом, с указанным вычтенным количеством. Количество обычно Period но может быть любой другой тип, реализовывая TemporalAmount интерфейс.
    Вычисление делегируется к объекту количества, вызывая TemporalAmount.subtractFrom(Temporal). Реализация количества свободна реализовать вычитание всегда, это желает, однако это обычно перезванивает к minus(long, TemporalUnit). Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно вычтено.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Определенный:
    
    minus в интерфейсе Temporal
    
    Параметры:
    
    amountToSubtract - количество, чтобы вычесть, не нуль
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом со сделанным вычитанием, не нуль
    
    Броски:
    
    DateTimeException - если вычитание не может быть сделано
    
    ArithmeticException - если числовое переполнение происходит
  - минус
```
public YearMonth minus(long amountToSubtract,
                       TemporalUnit unit)
```
    Возвращает копию этого месячного годом с указанным вычтенным количеством.
    Это возвращает a YearMonth, основанный на этом, с количеством с точки зрения модуля вычитается. Если не возможно вычесть количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
    Этот метод эквивалентен plus(long, TemporalUnit) с отрицаемым количеством. См., что метод для полного описания того, как дополнение, и таким образом вычитание, работают.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Определенный:
    
    minus в интерфейсе Temporal
    
    Параметры:
    
    amountToSubtract - количество модуля, чтобы вычесть из результата, может быть отрицательным
    
    unit - модуль количества, чтобы вычесть, не нуль
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом с указанным вычтенным количеством, не нуль
    
    Броски:
    
    DateTimeException - если вычитание не может быть сделано
    
    UnsupportedTemporalTypeException - если модуль не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - minusYears
```
public YearMonth minusYears(long yearsToSubtract)
```
    Возвращает копию этого месячного годом с установленным периодом в вычтенных годах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    yearsToSubtract - годы, чтобы вычесть, может быть отрицательным
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом с вычтенными годами, не нуль
    
    Броски:
    
    DateTimeException - если результат превышает поддерживаемый диапазон
  - minusMonths
```
public YearMonth minusMonths(long monthsToSubtract)
```
    Возвращает копию этого месячного годом с установленным периодом в вычтенных месяцах.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    
    Параметры:
    
    monthsToSubtract - месяцы, чтобы вычесть, может быть отрицательным
    
    Возвраты:
    
    a YearMonth основанный на этом месячном годом с вычтенными месяцами, не нуль
    
    Броски:
    
    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.PROLEPTIC_MONTH как поле. Если указанный временный объект не использует календарную систему ISO тогда a DateTimeException бросается.
    В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.with(TemporalAdjuster):
```
   // these two lines are equivalent, but the second approach is recommended
   temporal = thisYearMonth.adjustInto(temporal);
   temporal = temporal.with(thisYearMonth);
 
```
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    adjustInto в интерфейсе TemporalAdjuster
    
    Параметры:
    
    temporal - целевой объект, который будет скорректирован, не нуль
    
    Возвраты:
    
    скорректированный объект, не нуль
    
    Броски:
    
    DateTimeException - если неспособный вносить корректировку
    
    ArithmeticException - если числовое переполнение происходит
  - periodUntil
```
public long periodUntil(Temporal endYearMonth,
                        TemporalUnit unit)
```
    Вычисляет количество времени до другого месячного годом с точки зрения указанного модуля.
    Это вычисляет количество времени между два YearMonth объекты с точки зрения сингла TemporalUnit. Запуск и конечные точки this и указанное месячное годом. Результат будет отрицателен, если конец будет перед запуском. Temporal переданный к этому методу должен быть a YearMonth. Например, период в годах между двумя месяцами года может быть вычислен, используя startYearMonth.periodUntil(endYearMonth, YEARS).
    Вычисление возвращает целое число, представляя число полных модулей между этими двумя месяцами года. Например, период в десятилетиях между 2012-06 и 2032-05 только будет одним десятилетием, поскольку это - один месяц за исключением двух десятилетий.
    Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод. Второе должно использовать TemporalUnit.between(Temporal, Temporal):
```
   // these two lines are equivalent
   amount = start.periodUntil(end, MONTHS);
   amount = MONTHS.between(start, end);
 
```
    Выбор должен быть сделан основанный, которого делает код более читаемым.
    Вычисление реализуется в этом методе для ChronoUnit. Модули MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA и ERAS поддерживаются. Другой ChronoUnit значения выдадут исключение.
    Если модуль не является a ChronoUnit, тогда результат этого метода получается, вызывая TemporalUnit.between(Temporal, Temporal) передача this как первый параметр и ввод, временный как второй параметр.
    Этот экземпляр является неизменным и незатронутым этим вызовом метода.
    Определенный:
    
    periodUntil в интерфейсе Temporal
    
    Параметры:
    
    endYearMonth - месячный годом конец, который должен быть a YearMonth, не нуль
    
    unit - модуль, чтобы измерить количество в, не нуль
    
    Возвраты:
    
    количество времени между этим месячным годом и месячным годом концом
    
    Броски:
    
    DateTimeException - если количество не может быть вычислено
    
    UnsupportedTemporalTypeException - если модуль не поддерживается
    
    ArithmeticException - если числовое переполнение происходит
  - формат
```
public String format(DateTimeFormatter formatter)
```
    Форматы это месячное годом использование указанного средства форматирования.
    Это месячное годом передадут к средству форматирования, чтобы произвести строку.
    
    Параметры:
    
    formatter - средство форматирования, чтобы использовать, не нуль
    
    Возвраты:
    
    отформатированная месячная годом строка, не нуль
    
    Броски:
    
    DateTimeException - если ошибка происходит во время печати
  - atDay
```
public LocalDate atDay(int dayOfMonth)
```
    Комбинирует это месячное годом со днем-месячного, чтобы создать a LocalDate.
    Это возвращает a LocalDate сформированный из этого месячного годом и указанный день-месячного.
    Дневное-месячного значение должно быть допустимым для месячного годом.
    Этот метод может использоваться в качестве части цепочки, чтобы произвести дату:
```
  LocalDate date = year.atMonth(month).atDay(day);
 
```
    Параметры:
    
    dayOfMonth - день-месячного, чтобы использовать, от 1 до 31
    
    Возвраты:
    
    дата, сформированная из этого месячного годом и указанный день, не нуль
    
    Броски:
    
    DateTimeException - если день недопустим для месячного годом
    
    См. Также:
    
    isValidDay(int)
  - atEndOfMonth
```
public LocalDate atEndOfMonth()
```
    Возвраты a LocalDate в конце месяца.
    Это возвращает a LocalDate основанный на этом месячном годом. День-месячного устанавливается в прошлый допустимый день месяца, принимая во внимание високосные годы.
    Этот метод может использоваться в качестве части цепочки, чтобы произвести дату:
```
  LocalDate date = year.atMonth(month).atEndOfMonth();
 
```
    Возвраты:
    
    последняя допустимая дата этого месячного годом, не нулевой
  - compareTo
```
public int compareTo(YearMonth other)
```
    Сравнивает это месячное годом с другим месячным годом.
    Сравнение базируется сначала на значении года, затем на значении месяца. Это является "непротиворечивым с, равняется", как определено Comparable.
    
    Определенный:
    
    compareTo в интерфейсе Comparable<YearMonth>
    
    Параметры:
    
    other - другое месячное годом, чтобы сравнить с, не нуль
    
    Возвраты:
    
    значение компаратора, отрицательное, если меньше, положительный если больше
  - isAfter
```
public boolean isAfter(YearMonth other)
```
    Это месячное годом после указанного месячного годом.
    
    Параметры:
    
    other - другое месячное годом, чтобы сравнить с, не нуль
    
    Возвраты:
    
    истина, если это после указанного месячного годом
  - isBefore
```
public boolean isBefore(YearMonth 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, такой как 2007-12.
    Вывод будет в формате uuuu-MM:
    
    Переопределения:
    
    toString в class Object
    
    Возвраты:
    
    строковое представление этого месячного годом, не нулевой

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

Класс YearMonth

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

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

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

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

теперь

теперь

теперь

из

из

от

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

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

isSupported

диапазон

добраться

getLong

getYear

getMonthValue

getMonth

isLeapYear

isValidDay

lengthOfMonth

lengthOfYear

с

с

withYear

withMonth

плюс

плюс

plusYears

plusMonths

минус

минус

minusYears

minusMonths

запрос

adjustInto

periodUntil

формат

atDay

atEndOfMonth

compareTo

isAfter

isBefore

равняется

хэш-код

toString