Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class MonthDay extends Object implements TemporalAccessor, TemporalAdjuster, Comparable<MonthDay>, Serializable
--12-03
.
MonthDay
неизменный разовый датой объект, который представляет комбинацию года и месяца. Любое поле, которое может быть получено с месяца и дня, такого как четверть-летнего, может быть получено.
Этот class не хранит или представляет год, время или часовой пояс. Например, значение "3-ьего декабря" может быть сохранено в a MonthDay
.
С тех пор a MonthDay
не обладает годом, день прыжка от 29-ого февраля считают допустимым.
Этот class реализации TemporalAccessor
вместо Temporal
. Это - то, потому что не возможно определить, допустимо ли 29-ого февраля или не без внешней информации, предотвращая реализацию плюс/минус. Связанный с этим, MonthDay
только обеспечивает доступ к запросу и устанавливает поля MONTH_OF_YEAR
и DAY_OF_MONTH
.
Календарная система ISO 8601 является современной гражданской календарной системой, используемой сегодня в большей части мира. Это эквивалентно преждевременной системе Григорианского календаря, в которой сегодняшние правила в течение многих високосных годов применяются навсегда. Для большинства приложений, записанных сегодня, правила ISO 8601 являются полностью подходящими. Однако, любое приложение, которое использует исторические даты, и требует, чтобы они были точны, сочтет подход ISO 8601 неподходящим.
Модификатор и Тип | Метод и Описание |
---|---|
Временный |
adjustInto(Temporal temporal)
Корректирует указанный временный объект иметь это дневное месяцем.
|
LocalDate |
atYear(int year)
Комбинирует это дневное месяцем с годом, чтобы создать a
LocalDate . |
int |
compareTo(MonthDay other)
Сравнивает это дневное месяцем с другим дневным месяцем.
|
boolean |
equals(Object obj)
Проверки, если это дневное месяцем равно другому дневному месяцем.
|
Строка |
format(DateTimeFormatter formatter)
Форматы это дневное месяцем использование указанного средства форматирования.
|
static MonthDay |
from(TemporalAccessor temporal)
Получает экземпляр
MonthDay от временного объекта. |
int |
get(TemporalField field)
Получает значение указанного поля от этого дневного месяцем как
int . |
int |
getDayOfMonth()
Получает дневное-месячного поле.
|
long |
getLong(TemporalField field)
Получает значение указанного поля от этого дневного месяцем как a
long . |
Месяц |
getMonth()
Получает поле месяца-летнего, используя
Month перечисление. |
int |
getMonthValue()
Получает поле месяца-летнего от 1 до 12.
|
int |
hashCode()
Хэш-код для этого дневного месяцем.
|
boolean |
isAfter(MonthDay other)
Это дневное месяцем после указанного дневного месяцем.
|
boolean |
isBefore(MonthDay other)
Это дневное месяцем перед указанным дневным месяцем.
|
boolean |
isSupported(TemporalField field)
Проверки, если указанное поле поддерживается.
|
boolean |
isValidYear(int year)
Проверки, если год допустим для этого дневного месяцем.
|
static MonthDay |
now()
Получает ток, дневный месяцем из системных часов в часовом поясе значения по умолчанию.
|
static MonthDay |
now(Clock clock)
Получает ток, дневный месяцем из указанных часов.
|
static MonthDay |
now(ZoneId zone)
Получает ток, дневный месяцем из системных часов в указанном часовом поясе.
|
static MonthDay |
of(int month, int dayOfMonth)
Получает экземпляр
MonthDay . |
static MonthDay |
of(Month month, int dayOfMonth)
Получает экземпляр
MonthDay . |
static MonthDay |
parse(CharSequence text)
Получает экземпляр
MonthDay от текстовой строки такой как --12-03 . |
static MonthDay |
parse(CharSequence text, DateTimeFormatter formatter)
Получает экземпляр
MonthDay от текстовой строки, используя определенное средство форматирования. |
<R> R |
query(TemporalQuery<R> query)
Запросы это дневное месяцем использование указанного запроса.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
Строка |
toString()
Выводит это дневное месяцем как a
String , такой как --12-03 . |
MonthDay |
with(Month month)
Возвращает копию этого
MonthDay с измененным месяцем-летнего. |
MonthDay |
withDayOfMonth(int dayOfMonth)
Возвращает копию этого
MonthDay с измененным днем-месячного. |
MonthDay |
withMonth(int month)
Возвращает копию этого
MonthDay с измененным месяцем-летнего. |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame
public static MonthDay now()
Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить дневный месяцем ток.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
public static MonthDay now(ZoneId zone)
Это запросит system clock
получить дневный месяцем ток. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
zone
- зональный ID, чтобы использовать, не нульpublic static MonthDay now(Clock clock)
Это запросит указанные часы, чтобы получить дневный месяцем ток. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection
.
clock
- часы, чтобы использовать, не нульpublic static MonthDay of(Month month, int dayOfMonth)
MonthDay
. День-месячного должен быть допустимым в течение месяца в пределах високосного года. Следовательно, на февраль, день 29 допустим.
Например, передача в апреле и день 31 выдаст исключение, поскольку никогда не может быть 31-ого апреля в любом году. В отличие от этого, передача в феврале 29-ый разрешается, как, который дневный месяцем может иногда быть допустимым.
month
- месяц-летнего, чтобы представить, не нульdayOfMonth
- день-месячного, чтобы представить, от 1 до 31DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим в течение месяцаpublic static MonthDay of(int month, int dayOfMonth)
MonthDay
. День-месячного должен быть допустимым в течение месяца в пределах високосного года. Следовательно, в течение месяца 2 (февраль), день 29 допустим.
Например, передача в месяце 4 (апрель) и день 31 выдаст исключение, поскольку никогда не может быть 31-ого апреля в любом году. В отличие от этого, передача в феврале 29-ый разрешается, как, который дневный месяцем может иногда быть допустимым.
month
- месяц-летнего, чтобы представить, от 1 (январь) к 12 (декабрь)dayOfMonth
- день-месячного, чтобы представить, от 1 до 31DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим в течение месяцаpublic static MonthDay from(TemporalAccessor temporal)
MonthDay
от временного объекта. Это получает дневное месяцем основанное на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр MonthDay
.
Преобразование извлекает MONTH_OF_YEAR
и DAY_OF_MONTH
поля. Экстракция только разрешается, если у разового датой есть хронология ISO.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в запросах через ссылку метода, MonthDay::from
.
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a MonthDay
public static MonthDay parse(CharSequence text)
MonthDay
от текстовой строки такой как --12-03
. Строка должна представить допустимое дневное месяцем. Формат --MM-dd
.
text
- текст, чтобы проанализировать такой как "-12-03", не нульDateTimeParseException
- если текст не может быть проанализированpublic static MonthDay parse(CharSequence text, DateTimeFormatter formatter)
MonthDay
от текстовой строки, используя определенное средство форматирования. Текст анализируется, используя средство форматирования, возвращая дневное месяцем.
text
- текст, чтобы проанализировать, не нульformatter
- средство форматирования, чтобы использовать, не нульDateTimeParseException
- если текст не может быть проанализированpublic boolean isSupported(TemporalField field)
Это проверяет, может ли это дневное месяцем быть запрошено для указанного поля. Если ложь, то вызов range
и get
методы выдадут исключение.
Если поле является a ChronoField
тогда запрос реализуется здесь. Поддерживаемые поля:
MONTH_OF_YEAR
YEAR
ChronoField
экземпляры возвратят false. Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.isSupportedBy(TemporalAccessor)
передача this
как параметр. Поддерживается ли поле, определяется полем.
isSupported
в интерфейсе TemporalAccessor
field
- поле, чтобы проверить, обнулите, возвращает falsepublic 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
- если числовое переполнение происходитpublic long getLong(TemporalField field)
long
. Это запрашивает это дневное месяцем для значения для указанного поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField
тогда запрос реализуется здесь. supported fields
возвратит допустимые значения, основанные на этом дневном месяцем. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor)
передача this
как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
getLong
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульDateTimeException
- если значение для поля не может быть полученоUnsupportedTemporalTypeException
- если поле не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic int getMonthValue()
Этот метод возвращает месяц как int
от 1 до 12. Код программы является часто более четким если перечисление Month
используется, вызывая getMonth()
.
getMonth()
public Month getMonth()
Month
перечисление. Этот метод возвращает перечисление Month
в течение месяца. Это избегает беспорядка относительно какой int
среднее значение значений. Если Вы нуждаетесь в доступе к примитиву int
значение тогда перечисление обеспечивает int value
.
getMonthValue()
public int getDayOfMonth()
Этот метод возвращает примитив int
значение в течение дня-месячного.
public boolean isValidYear(int year)
Этот метод проверяет, формируют ли в этом месяце и день и входной год допустимую дату. Это может только возвратить false на 29-ое февраля.
year
- год, чтобы проверить, из значения диапазона возвращает falseYear.isValidMonthDay(MonthDay)
public MonthDay withMonth(int month)
MonthDay
с измененным месяцем-летнего. Это возвращает дневное месяцем с указанным месяцем. Если день-месячного будет недопустим в течение указанного месяца, то день будет скорректирован к прошлому допустимому дню-месячного.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
month
- месяц-летнего, чтобы установить в возвращенном дневном месяцем, от 1 (январь) к 12 (декабрь)MonthDay
основанный на этом дневном месяцем с требуемым месяцем, не нулемDateTimeException
- если значение месяца-летнего недопустимоpublic MonthDay with(Month month)
MonthDay
с измененным месяцем-летнего. Это возвращает дневное месяцем с указанным месяцем. Если день-месячного будет недопустим в течение указанного месяца, то день будет скорректирован к прошлому допустимому дню-месячного.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
month
- месяц-летнего, чтобы установить в возвращенном дневном месяцем, не нулевомMonthDay
основанный на этом дневном месяцем с требуемым месяцем, не нулемpublic MonthDay withDayOfMonth(int dayOfMonth)
MonthDay
с измененным днем-месячного. Это возвращает дневное месяцем с указанным днем-месячного. Если день-месячного недопустим в течение месяца, исключение выдается.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
dayOfMonth
- день-месячного, чтобы установить в дневном месяцем возврате, от 1 до 31MonthDay
основанный на этом дневном месяцем с требуемым днем, не нулемDateTimeException
- если дневное-месячного значение недопустимо, или если день-месячного недопустим в течение месяцаpublic <R> R query(TemporalQuery<R> query)
Это запрашивает это дневное месяцем использование указанного объекта стратегии запроса. TemporalQuery
объект определяет логику, которая будет использоваться, чтобы получить результат. Считайте документацию запроса, чтобы понять, каков результат этого метода будет.
Результат этого метода получается, вызывая TemporalQuery.queryFrom(TemporalAccessor)
метод на указанной передаче запроса this
как параметр.
query
в интерфейсе TemporalAccessor
R
- тип результатаquery
- запрос, чтобы вызвать, не нульDateTimeException
- если неспособный запрашивать (определенный запросом)ArithmeticException
- если числовое переполнение происходит (определенный запросом)public Temporal adjustInto(Temporal temporal)
Это возвращает временный объект того же самого заметного типа как ввод с месяцем и днем-месячного, измененным, чтобы быть тем же самым как этим.
Корректировка эквивалентна использованию Temporal.with(TemporalField, long)
дважды, передача ChronoField.MONTH_OF_YEAR
и ChronoField.DAY_OF_MONTH
как поля. Если указанный временный объект не использует календарную систему ISO тогда a DateTimeException
бросается.
В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.with(TemporalAdjuster)
:
// these two lines are equivalent, but the second approach is recommended temporal = thisMonthDay.adjustInto(temporal); temporal = temporal.with(thisMonthDay);
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
adjustInto
в интерфейсе TemporalAdjuster
temporal
- целевой объект, который будет скорректирован, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитpublic String format(DateTimeFormatter formatter)
Это дневное месяцем передадут к средству форматирования, чтобы произвести строку.
formatter
- средство форматирования, чтобы использовать, не нульDateTimeException
- если ошибка происходит во время печатиpublic LocalDate atYear(int year)
LocalDate
. Это возвращает a LocalDate
сформированный из этого дневного месяцем и указанный год.
Дневное месяцем от 29-ого февраля будет скорректировано до 28-ого февраля в получающейся дате, если год не будет високосным годом.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
year
- год, чтобы использовать, от MIN_YEAR до MAX_YEARDateTimeException
- если год вне допустимого диапазона летpublic int compareTo(MonthDay other)
Сравнение базируется сначала на значении месяца, затем на значении дня. Это является "непротиворечивым с, равняется", как определено Comparable
.
compareTo
в интерфейсе Comparable<MonthDay>
other
- другое дневное месяцем, чтобы сравнить с, не нульpublic boolean isAfter(MonthDay other)
other
- другое дневное месяцем, чтобы сравнить с, не нульpublic boolean isBefore(MonthDay other)
other
- другое дневное месяцем, чтобы сравнить с, не нульpublic boolean equals(Object obj)
Сравнение основано на позиции временной шкалы дневного месяцем в течение года.
equals
в class Object
obj
- объект проверить, обнулите, возвращает falseObject.hashCode()
, HashMap
public int hashCode()
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92