Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class HijrahDate extends Object implements ChronoLocalDate<HijrahDate>, Serializable
Эта дата управляет использованием одной из нескольких разновидностей календаря Hijrah.
У календаря Hijrah есть различное общее количество дней через год чем Григорианский календарь, и продолжительность каждого месяца основана на периоде полного оборота луны вокруг земли (как между последовательными новолуниями). Обратитесь к HijrahChronology
для деталей поддерживаемых разновидностей.
Каждый HijrahDate создается связанный с определенным HijrahChronology, та же самая хронология распространяется к каждому HijrahDate, вычисленному с даты. Чтобы использовать различную разновидность Hijrah, ее HijrahChronology может использоваться, чтобы создать новые экземпляры HijrahDate. Альтернативно, withVariant(java.time.chrono.HijrahChronology)
метод может использоваться, чтобы преобразовать в новый HijrahChronology.
Модификатор и Тип | Метод и Описание |
---|---|
ChronoLocalDateTime<HijrahDate> |
atTime(LocalTime localTime)
Комбинирует эту дату со временем, чтобы создать a
ChronoLocalDateTime . |
boolean |
equals(Object obj)
Указывает, " ли некоторый другой объект равен" этому.
|
static HijrahDate |
from(TemporalAccessor temporal)
Получает a
HijrahDate из исламского календаря Умма Аль-Куры от временного объекта. |
HijrahChronology |
getChronology()
Получает хронологию этой даты, которая является календарной системой Hijrah.
|
HijrahEra |
getEra()
Получает эру, применимую в этой дате.
|
long |
getLong(TemporalField field)
Получает значение указанного поля как a
long . |
int |
hashCode()
Возвращает значение хэш-кода для объекта.
|
boolean |
isLeapYear()
Проверки, если год является високосным годом согласно календарным системным правилам Hijrah.
|
int |
lengthOfMonth()
Возвращает продолжительность месяца, представленного этой датой.
|
int |
lengthOfYear()
Возвращает продолжительность года, представленного этой датой.
|
HijrahDate |
minus(long amountToSubtract, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с вычтенным установленным периодом.
|
HijrahDate |
minus(TemporalAmount amount)
Возвращает объект того же самого типа как этот объект с вычтенным количеством.
|
static HijrahDate |
now()
Получает ток
HijrahDate из исламского календаря Умма Аль-Куры в часовом поясе значения по умолчанию. |
static HijrahDate |
now(Clock clock)
Получает ток
HijrahDate из исламского календаря Умма Аль-Куры от указанных часов. |
static HijrahDate |
now(ZoneId zone)
Получает ток
HijrahDate из исламского календаря Умма Аль-Куры в указанном часовом поясе. |
static HijrahDate |
of(int prolepticYear, int month, int dayOfMonth)
Получает a
HijrahDate из исламского календаря Умма Аль-Куры от преждевременно-летнего, месяц-летнего и дневные-месячного поля. |
Период |
periodUntil(ChronoLocalDate<?> endDate)
Вычисляет период между этой датой и другой датой как a
Period . |
long |
periodUntil(Temporal endDateTime, TemporalUnit unit)
Вычисляет количество времени до другой даты с точки зрения указанного модуля.
|
HijrahDate |
plus(long amountToAdd, TemporalUnit unit)
Возвращает объект того же самого типа как этот объект с добавленным установленным периодом.
|
HijrahDate |
plus(TemporalAmount amount)
Возвращает объект того же самого типа как этот объект с добавленным количеством.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
long |
toEpochDay()
Преобразовывает эту дату в День Эпохи.
|
Строка |
toString()
Возвращает строковое представление объекта.
|
HijrahDate |
with(TemporalAdjuster adjuster)
Возвращает скорректированный объект того же самого типа как этот объект с внесенной корректировкой.
|
HijrahDate |
with(TemporalField field, long newValue)
Возвращает объект того же самого типа как этот объект с указанным измененным полем.
|
HijrahDate |
withVariant(HijrahChronology chronology)
Возвраты a
HijrahDate с Хронологией, которую требуют. |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
adjustInto, compareTo, equals, format, hashCode, isAfter, isBefore, isEqual, isSupported, periodUntil, query, timeLineOrder, toString
добраться
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame
public static HijrahDate now()
HijrahDate
из исламского календаря Умма Аль-Куры в часовом поясе значения по умолчанию. Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить текущую дату.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
public static HijrahDate now(ZoneId zone)
HijrahDate
из исламского календаря Умма Аль-Куры в указанном часовом поясе. Это запросит system clock
получить текущую дату. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
zone
- зональный ID, чтобы использовать, не нульpublic static HijrahDate now(Clock clock)
HijrahDate
из исламского календаря Умма Аль-Куры от указанных часов. Это запросит указанные часы, чтобы получить текущую дату - сегодня. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя внедрение зависимости.
clock
- часы, чтобы использовать, не нульDateTimeException
- если текущая дата не может быть полученаpublic static HijrahDate of(int prolepticYear, int month, int dayOfMonth)
HijrahDate
из исламского календаря Умма Аль-Куры от преждевременно-летнего, месяц-летнего и дневные-месячного поля. Это возвращает a HijrahDate
с указанными полями. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано.
prolepticYear
- преждевременно-летний Hijrahmonth
- месяц-летнего Hijrah, от 1 до 12dayOfMonth
- день-месячного Hijrah, от 1 до 30DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static HijrahDate from(TemporalAccessor temporal)
HijrahDate
из исламского календаря Умма Аль-Куры от временного объекта. Это получает дату в календарной системе Hijrah, основанной на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр HijrahDate
.
Преобразование обычно использует EPOCH_DAY
поле, которое стандартизируется через календарные системы.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, HijrahDate::from
.
from
в интерфейсе ChronoLocalDate<HijrahDate>
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a HijrahDate
Chronology.date(TemporalAccessor)
public HijrahChronology getChronology()
Chronology
представляет календарную систему в использовании. Эра и другие поля в ChronoField
определяются хронологией.
getChronology
в интерфейсе ChronoLocalDate<HijrahDate>
public HijrahEra getEra()
У календарной системы Hijrah есть одна эра, 'AH', определенный HijrahEra
.
getEra
в интерфейсе ChronoLocalDate<HijrahDate>
public int lengthOfMonth()
Это возвращает продолжительность месяца в днях. Длины месяца в календарной системе Hijrah изменяются между 29 и 30 днями.
lengthOfMonth
в интерфейсе ChronoLocalDate<HijrahDate>
public int lengthOfYear()
Это возвращает продолжительность года в днях. Календарный системный год Hijrah обычно короче чем та из календарной системы ISO.
lengthOfYear
в интерфейсе ChronoLocalDate<HijrahDate>
public ValueRange range(TemporalField field)
TemporalAccessor
Все поля могут быть выражены как a long
целое число. Этот метод возвращает объект, который описывает допустимый диапазон для того значения. Значение этого временного объекта используется, чтобы улучшить точность возвращенного диапазона. Если разовое датой не может возвратить диапазон, потому что поле неподдерживается или по некоторой другой причине, исключение будет выдано.
Отметьте, что результат только описывает минимальные и максимальные допустимые значения, и важно не читать слишком много в них. Например, могли быть значения в пределах диапазона, которые недопустимы для поля.
range
в интерфейсе TemporalAccessor
field
- поле, чтобы запросить диапазон для, не нульpublic long getLong(TemporalField field)
TemporalAccessor
long
. Это запрашивает разовое датой для значения для указанного поля. Возвращенное значение может быть вне допустимого диапазона значений для поля. Если разовое датой не может возвратить значение, потому что поле неподдерживается или по некоторой другой причине, исключение будет выдано.
getLong
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульpublic HijrahDate with(TemporalField field, long newValue)
ChronoLocalDate
Это возвращает новое основанное на объектах на этом со значением для указанного измененного поля. Например, на a LocalDate
, это могло использоваться, чтобы установить год, месяц или день-месячного. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если целевой объект является датой, представляющей 31-ого января, то изменение месяца до февраля было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
with
в интерфейсе ChronoLocalDate<HijrahDate>
with
в интерфейсе Temporal
field
- поле, чтобы установить в результате, не нулеnewValue
- новое значение поля в результатеpublic HijrahDate with(TemporalAdjuster adjuster)
Это корректирует это разовое датой согласно правилам указанного регулятора. Простой регулятор мог бы просто установить то из полей, таких как поле года. Более сложный регулятор мог бы назначить дату к прошлому дню месяца. В выборе общих корректировок обеспечивают TemporalAdjuster
. Они включают обнаружение "в последний день месяца" и "следующей среды". Регулятор ответственен за обработку особых случаев, таких как переменные продолжительности месяца и високосных годов.
Некоторый пример кода, указывающий, как и почему этот метод используется:
date = date.with(Month.JULY); // most key classes implement TemporalAdjuster date = date.with(lastDayOfMonth()); // static import from Adjusters date = date.with(next(WEDNESDAY)); // static import from Adjusters and DayOfWeek
with
в интерфейсе ChronoLocalDate<HijrahDate>
with
в интерфейсе Temporal
adjuster
- регулятор, чтобы использовать, не нульDateTimeException
- если неспособный вносить корректировку. Например, если регулятор требует хронологии ISOArithmeticException
- если числовое переполнение происходитpublic HijrahDate withVariant(HijrahChronology chronology)
HijrahDate
с Хронологией, которую требуют. Год, месяц, и день проверяются по новому требуемому HijrahChronology. Если у хронологии есть более короткая длина месяца в течение месяца, день уменьшается, чтобы быть прошлым днем месяца.
chronology
- новый HijrahChonology, ненульpublic HijrahDate plus(TemporalAmount amount)
Это корректирует это временное, добавляя согласно правилам указанного количества. Количество обычно a Period
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс, такой как Duration
.
Некоторый пример кода, указывающий, как и почему этот метод используется:
date = date.plus(period); // add a Period instance date = date.plus(duration); // add a Duration instance date = date.plus(workingDays(6)); // example user-written workingDays method
Отметьте тот вызов plus
сопровождаемый minus
как гарантируют, не возвратит разовое датой то же самое.
plus
в интерфейсе ChronoLocalDate<HijrahDate>
plus
в интерфейсе Temporal
amount
- количество, чтобы добавить, не нульDateTimeException
- если дополнение не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic HijrahDate minus(TemporalAmount amount)
Это корректирует это временное, вычитая согласно правилам указанного количества. Количество обычно a Period
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс, такой как Duration
.
Некоторый пример кода, указывающий, как и почему этот метод используется:
date = date.minus(period); // subtract a Period instance date = date.minus(duration); // subtract a Duration instance date = date.minus(workingDays(6)); // example user-written workingDays method
Отметьте тот вызов plus
сопровождаемый minus
как гарантируют, не возвратит разовое датой то же самое.
minus
в интерфейсе ChronoLocalDate<HijrahDate>
minus
в интерфейсе Temporal
amount
- количество, чтобы вычесть, не нульDateTimeException
- если вычитание не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic long toEpochDay()
ChronoLocalDate
Epoch Day count
простое количество постепенного увеличения дней, где день 0 01.01.1970 (ISO). Это определение является тем же самым для всех хронологий, включая преобразованию.
Эта реализация по умолчанию запрашивает EPOCH_DAY
поле.
toEpochDay
в интерфейсе ChronoLocalDate<HijrahDate>
public boolean isLeapYear()
isLeapYear
в интерфейсе ChronoLocalDate<HijrahDate>
public HijrahDate plus(long amountToAdd, TemporalUnit unit)
ChronoLocalDate
Этот метод возвращает новое основанное на объектах на этом с добавленным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы добавить много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого января, то добавление одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
plus
в интерфейсе ChronoLocalDate<HijrahDate>
plus
в интерфейсе Temporal
amountToAdd
- количество указанного модуля, чтобы добавить, может быть отрицательнымunit
- модуль периода, чтобы добавить, не нульpublic HijrahDate minus(long amountToSubtract, TemporalUnit unit)
ChronoLocalDate
Этот метод возвращает новое основанное на объектах на этом с вычтенным установленным периодом. Например, на a LocalDate
, это могло использоваться, чтобы вычесть много лет, месяцев или дней. У возвращенного объекта будет тот же самый заметный тип как этот объект.
В некоторых случаях изменение поля не полностью определяется. Например, если бы целевой объект является датой, представляющей 31-ого марта, то вычитание одного месяца было бы неясно. В случаях как это поле ответственно за разрешение результата. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
minus
в интерфейсе ChronoLocalDate<HijrahDate>
minus
в интерфейсе Temporal
amountToSubtract
- количество указанного модуля, чтобы вычесть, может быть отрицательнымunit
- модуль периода, чтобы вычесть, не нульpublic final ChronoLocalDateTime<HijrahDate> atTime(LocalTime localTime)
ChronoLocalDate
ChronoLocalDateTime
. Это возвращает a ChronoLocalDateTime
сформированный из этой даты в требуемое время. Все возможные комбинации даты и время допустимы.
atTime
в интерфейсе ChronoLocalDate<HijrahDate>
localTime
- местное время, чтобы использовать, не нульpublic Period periodUntil(ChronoLocalDate<?> endDate)
ChronoLocalDate
Period
. Это вычисляет период между двумя датами с точки зрения лет, месяцев и дней. Запуск и конечные точки this
и указанная дата. Результат будет отрицателен, если конец будет перед запуском. Знак минус будет тем же самым в каждом годе, месяце и дне.
Вычисление выполняется, используя хронологию этой даты. В случае необходимости входная дата будет преобразована в соответствие.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
periodUntil
в интерфейсе ChronoLocalDate<HijrahDate>
endDate
- дата окончания, монопольная, который может быть в любой хронологии, не нулеpublic long periodUntil(Temporal endDateTime, TemporalUnit unit)
Это вычисляет количество времени между два ChronoLocalDate
объекты с точки зрения сингла TemporalUnit
. Запуск и конечные точки this
и указанная дата. Результат будет отрицателен, если конец будет перед запуском. Temporal
переданный к этому методу должен быть a ChronoLocalDate
в той же самой хронологии. Вычисление возвращает целое число, представляя число полных модулей между этими двумя датами. Например, количество в днях между двумя датами может быть вычислено, используя startDate.periodUntil(endDate, DAYS)
.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод. Второе должно использовать TemporalUnit.between(Temporal, Temporal)
:
// these two lines are equivalent amount = start.periodUntil(end, MONTHS); amount = MONTHS.between(start, end);Выбор должен быть сделан основанный, которого делает код более читаемым.
Вычисление реализуется в этом методе для ChronoUnit
. Модули DAYS
, WEEKS
, MONTHS
, YEARS
, DECADES
, CENTURIES
, MILLENNIA
и ERAS
должен поддерживаться всеми реализациями. Другой ChronoUnit
значения выдадут исключение.
Если модуль не является a ChronoUnit
, тогда результат этого метода получается, вызывая TemporalUnit.between(Temporal, Temporal)
передача this
как первый параметр и ввод, временный как второй параметр.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
periodUntil
в интерфейсе ChronoLocalDate<D extends ChronoLocalDate<D>>
periodUntil
в интерфейсе Temporal
endDateTime
- дата окончания, которая должна быть a ChronoLocalDate
в той же самой хронологии, не нулеunit
- модуль, чтобы измерить количество в, не нульDateTimeException
- если количество не может быть вычисленоArithmeticException
- если числовое переполнение происходитpublic boolean equals(Object obj)
Object
equals
метод реализует отношение эквивалентности на ненулевых ссылках на объект:
x
, x.equals(x)
должен возвратиться true
. x
и y
, x.equals(y)
должен возвратиться true
если и только если y.equals(x)
возвраты true
. x
, y
, и z
, если x.equals(y)
возвраты true
и y.equals(z)
возвраты true
, тогда x.equals(z)
должен возвратиться true
. x
и y
, многократные вызовы x.equals(y)
последовательно возвращайтесь true
или последовательно возвращайтесь false
, предоставленный никакая информация, используемая в equals
сравнения на объектах изменяются. x
, x.equals(null)
должен возвратиться false
. equals
метод для class Object
реализует самое отличительное отношение эквивалентности на объектах; то есть, для любых ненулевых ссылочных значений x
и y
, этот метод возвраты true
если и только если x
и y
обратитесь к тому же самому объекту (x == y
имеет значение true
).
Отметьте, что обычно необходимо переопределить hashCode
метод всякий раз, когда этот метод переопределяется, чтобы поддержать общий контракт для hashCode
метод, который утверждает, что у равных объектов должны быть равные хэш-коды.
equals
в интерфейсе ChronoLocalDate<D extends ChronoLocalDate<D>>
equals
в class Object
obj
- ссылочный объект, с которым можно сравниться.true
если этот объект является тем же самым как obj параметром; false
иначе.Object.hashCode()
, HashMap
public int hashCode()
Object
HashMap
. Общий контракт hashCode
:
hashCode
метод должен последовательно возвращать то же самое целое число, не предоставил информации, используемой в equals
сравнения на объекте изменяются. Эта целочисленная потребность не остается непротиворечивой от одного выполнения приложения к другому выполнению того же самого приложения. equals(Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к тому же самому целочисленному результату. Object.equals(java.lang.Object)
метод, затем вызывая hashCode
метод на каждом из двух объектов должен привести к отличным целочисленным результатам. Однако, программист должен знать, что приведение к отличным целочисленным результатам для неравных объектов может улучшить производительность хэш-таблиц. Столько, сколько разумно практично, метод хэш-кода, определенный class Object
действительно возвращает отличные целые числа для отличных объектов. (Это обычно реализуется, преобразовывая внутренний адрес объекта в целое число, но этот метод реализации не требуется языком программирования Java™.)
hashCode
в интерфейсе ChronoLocalDate<D extends ChronoLocalDate<D>>
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public String toString()
Object
toString
метод возвращает строку, которая "дословно представляет" этот объект. Результатом должно быть краткое, но информативное представление, которое легко для человека читать. Рекомендуется, чтобы все подклассы переопределили этот метод. toString
метод для class Object
возвращает строку, состоящую из имени class, которого объект является экземпляром, символ знака at-sign`@
', и шестнадцатеричное представление без знака хэш-кода объекта. Другими словами этот метод возвращает строку, равную значению:
getClass().getName() + '@' + Integer.toHexString(hashCode())
toString
в интерфейсе ChronoLocalDate<D extends ChronoLocalDate<D>>
toString
в class Object
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92