|
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, waitdayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSamepublic 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 MonthDaypublic 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 в интерфейсе TemporalAccessorfield - поле, чтобы проверить, обнулите, возвращает falsepublic ValueRange range(TemporalField field)
Объект диапазона выражает минимальные и максимальные допустимые значения для поля. Это дневное месяцем используется, чтобы улучшить точность возвращенного диапазона. Если не возможно возвратить диапазон, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField тогда запрос реализуется здесь. supported fields возвратит соответствующие экземпляры диапазона. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.rangeRefinedBy(TemporalAccessor) передача this как параметр. Может ли диапазон быть получен, определяется полем.
range в интерфейсе TemporalAccessorfield - поле, чтобы запросить диапазон для, не нульDateTimeException - если диапазон для поля не может быть полученUnsupportedTemporalTypeException - если поле не поддерживаетсяpublic int get(TemporalField field)
int. Это запрашивает это дневное месяцем для значения для указанного поля. Возвращенное значение всегда будет в пределах допустимого диапазона значений для поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField тогда запрос реализуется здесь. supported fields возвратит допустимые значения, основанные на этом дневном месяцем. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor) передача this как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
get в интерфейсе TemporalAccessorfield - поле, чтобы получить, не нульDateTimeException - если значение для поля не может быть получено, или значение вне диапазона допустимых значений для поляUnsupportedTemporalTypeException - если поле не поддерживается, или диапазон значений превышает intArithmeticException - если числовое переполнение происходитpublic long getLong(TemporalField field)
long. Это запрашивает это дневное месяцем для значения для указанного поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField тогда запрос реализуется здесь. supported fields возвратит допустимые значения, основанные на этом дневном месяцем. Все другой ChronoField экземпляры бросят UnsupportedTemporalTypeException.
Если поле не является a ChronoField, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor) передача this как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
getLong в интерфейсе TemporalAccessorfield - поле, чтобы получить, не нуль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 в интерфейсе TemporalAccessorR - тип результата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 в интерфейсе TemporalAdjustertemporal - целевой объект, который будет скорректирован, не нуль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 Objectobj - объект проверить, обнулите, возвращает falseObject.hashCode(), HashMappublic int hashCode()
hashCode в class ObjectObject.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92