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

java.lang. Объект
- java.time.chrono. Хронология
- - java.time.chrono. HijrahChronology

Все Реализованные Интерфейсы:: Сериализуемый, Сопоставимый <Хронология>

public final class HijrahChronology
extends Chronology
implements Serializable

Календарь Hijrah является лунным календарем, поддерживающим исламские календари.

HijrahChronology следует за правилами календарной системы Hijrah. У календаря Hijrah есть несколько разновидностей, основанных на различиях в том, когда новолуние решается произойти и где наблюдение делается. В некоторых разновидностях продолжительность каждого месяца вычисляется алгоритмически от астрономических данных для луны и земли, и в других продолжительность месяца определяется авторизованным наблюдением новолуния. Для алгоритмически основанных календарей календарь может спроектировать в будущее. Для того, чтобы увидеть базируемые календари только исторические данные от прошлых наблюдений доступны.

Продолжительность каждого месяца составляет 29 или 30 дней. У обычных лет есть 354 дня; у високосных годов есть 355 дней.

CLDR и LDML идентифицируют разновидности:

ID хронологии	Тип календаря	Расширение локали, см. `Locale`	Описание
Hijrah-umalqura	исламский-umalqura	ca-islamic-cv-umalqura	Исламский - календарь Умма Аль-Куры Саудовской Аравии

Дополнительные разновидности могут быть доступными через Chronology.getAvailableChronologies().

Пример

Выбор хронологии от использования локали Chronology.ofLocale(java.util.Locale) счесть Хронологию основанной на Локали поддерживаемый BCP 47 механизмов расширения, чтобы запросить определенный календарь ("приблизительно") и разновидность ("условная цена"). Например,

      Locale locale = Locale.forLanguageTag("en-US-u-ca-islamic-cv-umalqura");
      Chronology chrono = Chronology.ofLocale(locale);

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

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

Примечание реализации:

Каждая разновидность Hijrah конфигурируется индивидуально. Каждая разновидность определяется ресурсом свойства, который определяет ID, calendar type, запуск календаря, выравнивания с календарем ISO, и продолжительности каждого месяца для диапазона лет. Разновидности идентифицируются в calendars.properties файл. Новые свойства снабжаются префиксом "calendars.hijrah.":

Имя свойства	Значение свойства	Описание
calendars.hijrah. {ID}	Ресурс свойства, определяющий `{ID}` разновидность	Ресурс свойства располагается с `calendars.properties` файл
calendars.hijrah. {ID}.type	Тип календаря	LDML определяет имена типа календаря

Ресурс свойства Hijrah является рядом свойств, которые описывают календарь. Синтаксис определяется java.util.Properties#load(Reader).

Имя свойства	Значение свойства	Описание
идентификатор	Идентификатор хронологии, например, "Hijrah-umalqura"	Идентификатор календаря в общем пользовании
ввести	Тип календаря, например, "исламский-umalqura"	LDML определяет типы календаря
версия	Версия, например: "1.8.0_1"	Версия данных разновидности Hijrah
запустить международная организация по стандартизации	Дата начала ISO, отформатированная как `yyyy-MM-dd`, например: "1900-04-30"	Дата ISO первого дня минимального года Hijrah.
yyyy - числовые 4 года цифры, например "1434"	Значение является последовательностью 12-месячных длин, например: "29 30 29 30 29 30 30 30 29 30 29 29"	Продолжительности 12 месяцев года отделились пробелом. Числовое свойство года должно присутствовать в течение каждого года без любых разрывов. Длины месяца должны быть между 29-32 включительно.

С тех пор:

1.8

См. Также:

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

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

Поля
Модификатор и Тип	Поле и Описание
`static HijrahChronology`	`ЭКЗЕМПЛЯР` Экземпляр Singleton исламского календаря Умма Аль-Куры Саудовской Аравии.

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

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`HijrahDate`	`date(Era era, int yearOfEra, int month, int dayOfMonth)` Получает локальную дату в календарной системе Hijrah с эры, года эры, месяца-летнего и дневных-месячного полей.
`HijrahDate`	`date(int prolepticYear, int month, int dayOfMonth)` Получает локальную дату в календарной системе Hijrah от преждевременно-летнего, месяц-летнего и дневные-месячного поля.
`HijrahDate`	`date(TemporalAccessor temporal)` Получает локальную дату в этой хронологии от другого временного объекта.
`HijrahDate`	`dateEpochDay(long epochDay)` Получает локальную дату в календарной системе Hijrah от дневного эпохой.
`HijrahDate`	`dateNow()` Получает текущую локальную дату в этой хронологии от системных часов в часовом поясе значения по умолчанию.
`HijrahDate`	`dateNow(Clock clock)` Получает текущую локальную дату в этой хронологии от указанных часов.
`HijrahDate`	`dateNow(ZoneId zone)` Получает текущую локальную дату в этой хронологии от системных часов в указанном часовом поясе.
`HijrahDate`	`dateYearDay(Era era, int yearOfEra, int dayOfYear)` Получает локальную дату в календарной системе Hijrah с эры, года эры и дневных-летнего полей.
`HijrahDate`	`dateYearDay(int prolepticYear, int dayOfYear)` Получает локальную дату в календарной системе Hijrah от преждевременно-летних полей и дневных-летнего полей.
`Эра`	`eraOf(int eraValue)` Создает объект эры хронологии из числового значения.
`List<Era>`	`eras()` Получает список эр для хронологии.
`Строка`	`getCalendarType()` Получает тип календаря исламского календаря.
`Строка`	`getId()` Получает ID хронологии.
`boolean`	`isLeapYear(long prolepticYear)` Проверки, если указанный год является високосным годом.
`ChronoLocalDateTime<HijrahDate>`	`localDateTime(TemporalAccessor temporal)` Получает локальную переменную, разовую датой в этой хронологии от другого временного объекта.
`int`	`prolepticYear(Era era, int yearOfEra)` Вычисляет преждевременно-летнее, данное эру и год эры.
`ValueRange`	`range(ChronoField field)` Получает диапазон допустимых значений для указанного поля.
`ChronoZonedDateTime<HijrahDate>`	`zonedDateTime(Instant instant, ZoneId zone)` Получает a `ChronoZonedDateTime` в этой хронологии от `Instant`.
`ChronoZonedDateTime<HijrahDate>`	`zonedDateTime(TemporalAccessor temporal)` Получает a `ChronoZonedDateTime` в этой хронологии от другого временного объекта.

Методы, наследованные от class java.time.chrono. Хронология
compareTo, equals, from, getAvailableChronologies, getDisplayName, hashCode, of, ofLocale, resolveDate, toString, writeReplace

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

- Полевая Деталь
  - ЭКЗЕМПЛЯР
```
public static final HijrahChronology INSTANCE
```
    Экземпляр Singleton исламского календаря Умма Аль-Куры Саудовской Аравии. Другие разновидности хронологии Hijrah могут быть доступными от Chronology.getAvailableChronologies().
- Деталь метода
  - getId
```
public String getId()
```
    Получает ID хронологии.
    ID однозначно определяет Chronology. Это может привыкнуть к поиску Chronology использование Chronology.of(String).
    
    Определенный:
    
    getId в class Chronology
    
    Возвраты:
    
    ID хронологии, ненуль
    
    См. Также:
    
    getCalendarType()
  - getCalendarType
```
public String getCalendarType()
```
    Получает тип календаря исламского календаря.
    Тип календаря является идентификатором, определенным Языком разметки Данных Локали Unicode (LDML) спецификация. Это может привыкнуть к поиску Chronology использование Chronology.of(String).
    
    Определенный:
    
    getCalendarType в class Chronology
    
    Возвраты:
    
    календарный системный тип; ненуль, если у календаря есть стандартный тип, иначе нуль
    
    См. Также:
    
    getId()
  - дата
```
public HijrahDate date(Era era,
                       int yearOfEra,
                       int month,
                       int dayOfMonth)
```
    Получает локальную дату в календарной системе Hijrah с эры, года эры, месяца-летнего и дневных-месячного полей.
    
    Переопределения:
    
    date в class Chronology
    
    Параметры:
    
    era - эра Hijrah, не нуль
    
    yearOfEra - год эры
    
    month - месяц-летнего
    
    dayOfMonth - день-месячного
    
    Возвраты:
    
    Hijrah локальная дата, не нуль
    
    Броски:
    
    DateTimeException - если неспособный создать дату
    
    ClassCastException - если era не a HijrahEra
  - дата
```
public HijrahDate date(int prolepticYear,
                       int month,
                       int dayOfMonth)
```
    Получает локальную дату в календарной системе Hijrah от преждевременно-летнего, месяц-летнего и дневные-месячного поля.
    
    Определенный:
    
    date в class Chronology
    
    Параметры:
    
    prolepticYear - преждевременно-летнее
    
    month - месяц-летнего
    
    dayOfMonth - день-месячного
    
    Возвраты:
    
    Hijrah локальная дата, не нуль
    
    Броски:
    
    DateTimeException - если неспособный создать дату
  - dateYearDay
```
public HijrahDate dateYearDay(Era era,
                              int yearOfEra,
                              int dayOfYear)
```
    Получает локальную дату в календарной системе Hijrah с эры, года эры и дневных-летнего полей.
    
    Переопределения:
    
    dateYearDay в class Chronology
    
    Параметры:
    
    era - эра Hijrah, не нуль
    
    yearOfEra - год эры
    
    dayOfYear - день-летнего
    
    Возвраты:
    
    Hijrah локальная дата, не нуль
    
    Броски:
    
    DateTimeException - если неспособный создать дату
    
    ClassCastException - если era не a HijrahEra
  - dateYearDay
```
public HijrahDate dateYearDay(int prolepticYear,
                              int dayOfYear)
```
    Получает локальную дату в календарной системе Hijrah от преждевременно-летних полей и дневных-летнего полей.
    
    Определенный:
    
    dateYearDay в class Chronology
    
    Параметры:
    
    prolepticYear - преждевременно-летнее
    
    dayOfYear - день-летнего
    
    Возвраты:
    
    Hijrah локальная дата, не нуль
    
    Броски:
    
    DateTimeException - если неспособный создать дату
  - dateEpochDay
```
public HijrahDate dateEpochDay(long epochDay)
```
    Получает локальную дату в календарной системе Hijrah от дневного эпохой.
    
    Определенный:
    
    dateEpochDay в class Chronology
    
    Параметры:
    
    epochDay - день эпохи
    
    Возвраты:
    
    Hijrah локальная дата, не нуль
    
    Броски:
    
    DateTimeException - если неспособный создать дату
  - dateNow
```
public HijrahDate dateNow()
```
    Описание скопировало с class: Chronology
    
    Получает текущую локальную дату в этой хронологии от системных часов в часовом поясе значения по умолчанию.
    Это запросит system clock в часовом поясе значения по умолчанию, чтобы получить текущую дату.
    Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
    Эта реализация использование Chronology.dateNow(Clock).
    
    Переопределения:
    
    dateNow в class Chronology
    
    Возвраты:
    
    текущая локальная дата, используя системные часы и часовой пояс значения по умолчанию, не нуль
  - dateNow
```
public HijrahDate dateNow(ZoneId zone)
```
    Описание скопировало с class: Chronology
    
    Получает текущую локальную дату в этой хронологии от системных часов в указанном часовом поясе.
    Это запросит system clock получить текущую дату. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
    Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
    
    Переопределения:
    
    dateNow в class Chronology
    
    Параметры:
    
    zone - зональный ID, чтобы использовать, не нуль
    
    Возвраты:
    
    текущая локальная дата, используя системные часы, не нуль
  - dateNow
```
public HijrahDate dateNow(Clock clock)
```
    Описание скопировало с class: Chronology
    
    Получает текущую локальную дату в этой хронологии от указанных часов.
    Это запросит указанные часы, чтобы получить текущую дату - сегодня. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection.
    
    Переопределения:
    
    dateNow в class Chronology
    
    Параметры:
    
    clock - часы, чтобы использовать, не нуль
    
    Возвраты:
    
    текущая локальная дата, не нуль
  - дата
```
public HijrahDate date(TemporalAccessor temporal)
```
    Описание скопировало с class: Chronology
    
    Получает локальную дату в этой хронологии от другого временного объекта.
    Это получает дату в этой хронологии, основанной на указанном временном. A TemporalAccessor представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр ChronoLocalDate.
    Преобразование обычно использует EPOCH_DAY поле, которое стандартизируется через календарные системы.
    Этот метод соответствует подпись функционального интерфейса TemporalQuery разрешение этого использоваться в качестве запроса через ссылку метода, aChronology::date.
    
    Определенный:
    
    date в class Chronology
    
    Параметры:
    
    temporal - временный объект преобразовать, не нуль
    
    Возвраты:
    
    локальная дата в этой хронологии, не нуль
    
    См. Также:
    
    ChronoLocalDate.from(TemporalAccessor)
  - localDateTime
```
public ChronoLocalDateTime<HijrahDate> localDateTime(TemporalAccessor temporal)
```
    Описание скопировало с class: Chronology
    
    Получает локальную переменную, разовую датой в этой хронологии от другого временного объекта.
    Это получает разовое датой в этой хронологии, основанной на указанном временном. A TemporalAccessor представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр ChronoLocalDateTime.
    Преобразование извлекает и объединяется ChronoLocalDate и LocalTime от временного объекта. Реализациям разрешают выполнить оптимизацию, такую как доступ к тем полям, которые эквивалентны соответствующим объектам. Результат использует эту хронологию.
    Этот метод соответствует подпись функционального интерфейса TemporalQuery разрешение этого использоваться в качестве запроса через ссылку метода, aChronology::localDateTime.
    
    Переопределения:
    
    localDateTime в class Chronology
    
    Параметры:
    
    temporal - временный объект преобразовать, не нуль
    
    Возвраты:
    
    локальная переменная, разовая датой в этой хронологии, не нуле
    
    См. Также:
    
    ChronoLocalDateTime.from(TemporalAccessor)
  - zonedDateTime
```
public ChronoZonedDateTime<HijrahDate> zonedDateTime(TemporalAccessor temporal)
```
    Описание скопировало с class: Chronology
    
    Получает a ChronoZonedDateTime в этой хронологии от другого временного объекта.
    Это получает зонное разовое датой в этой хронологии, основанной на указанном временном. A TemporalAccessor представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр ChronoZonedDateTime.
    Преобразование сначала получит a ZoneId от временного объекта, отступая к a ZoneOffset в случае необходимости. Это тогда попытается получить Instant, отступание к a ChronoLocalDateTime в случае необходимости. Результатом будет любой комбинация ZoneId или ZoneOffset с Instant или ChronoLocalDateTime. Реализациям разрешают выполнить оптимизацию, такую как доступ к тем полям, которые эквивалентны соответствующим объектам. Результат использует эту хронологию.
    Этот метод соответствует подпись функционального интерфейса TemporalQuery разрешение этого использоваться в качестве запроса через ссылку метода, aChronology::zonedDateTime.
    
    Переопределения:
    
    zonedDateTime в class Chronology
    
    Параметры:
    
    temporal - временный объект преобразовать, не нуль
    
    Возвраты:
    
    зонное разовое датой в этой хронологии, не нуль
    
    См. Также:
    
    ChronoZonedDateTime.from(TemporalAccessor)
  - zonedDateTime
```
public ChronoZonedDateTime<HijrahDate> zonedDateTime(Instant instant,
                                                     ZoneId zone)
```
    Описание скопировало с class: Chronology
    
    Получает a ChronoZonedDateTime в этой хронологии от Instant.
    Это получает зонное разовое датой с тем же самым моментом, как это определило.
    
    Переопределения:
    
    zonedDateTime в class Chronology
    
    Параметры:
    
    instant - момент, чтобы создать разовое датой из, не нуль
    
    zone - часовой пояс, не нуль
    
    Возвраты:
    
    зонное разовое датой, не нулевое
  - isLeapYear
```
public boolean isLeapYear(long prolepticYear)
```
    Описание скопировало с class: Chronology
    Проверки, если указанный год является високосным годом.
    Високосный год является годом более длительной длины чем нормальный. Точное значение определяется хронологией согласно следующим ограничениям.
    - високосный год должен подразумевать длиной до года дольше чем не високосный год.
    - хронология, которая не поддерживает понятие года, должна возвратить false.
    Определенный:
    
    isLeapYear в class Chronology
    
    Параметры:
    
    prolepticYear - преждевременно-летнее, чтобы проверить, не проверил для диапазона
    
    Возвраты:
    
    истина, если год является високосным годом
  - prolepticYear
```
public int prolepticYear(Era era,
                         int yearOfEra)
```
    Описание скопировало с class: Chronology
    
    Вычисляет преждевременно-летнее, данное эру и год эры.
    Это комбинирует эру и год эры в единственное преждевременно-летнее поле.
    Если хронология делает активное использование эр, такой как JapaneseChronology тогда год эры будет проверен против эры. Для других хронологий проверка допустимости является дополнительной.
    
    Определенный:
    
    prolepticYear в class Chronology
    
    Параметры:
    
    era - эра корректного типа для хронологии, не нуль
    
    yearOfEra - год эры хронологии
    
    Возвраты:
    
    преждевременно-летнее
  - eraOf
```
public Era eraOf(int eraValue)
```
    Описание скопировало с class: Chronology
    
    Создает объект эры хронологии из числового значения.
    Эра является, концептуально, крупнейшим подразделением временной шкалы. У большинства календарных систем есть единственная эпоха, делящая временную шкалу на две эры. Однако, у некоторых есть многократные эры, такой как один для господства каждого лидера. Точное значение определяется хронологией согласно следующим ограничениям.
    У эры в использовании 01.01.1970 должно быть значение 1. У более поздних эр должны быть последовательно более высокие значения. У более ранних эр должны быть последовательно нижние значения. Каждая хронология должна обратиться к перечислимому или подобному одиночному элементу, чтобы обеспечить значения эры.
    Этот метод возвращает одноэлементную эру корректного типа для указанного значения эры.
    
    Определенный:
    
    eraOf в class Chronology
    
    Параметры:
    
    eraValue - значение эры
    
    Возвраты:
    
    календарная системная эра, не нуль
  - эры
```
public List<Era> eras()
```
    Описание скопировало с class: Chronology
    
    Получает список эр для хронологии.
    У большинства календарных систем есть эра, в пределах которой у года есть значение. Если календарная система не поддерживает понятие эр, пустой список должен быть возвращен.
    
    Определенный:
    
    eras в class Chronology
    
    Возвраты:
    
    список эр для хронологии, может быть неизменным, не нулевым
  - диапазон
```
public ValueRange range(ChronoField field)
```
    Описание скопировало с class: Chronology
    
    Получает диапазон допустимых значений для указанного поля.
    Все поля могут быть выражены как a long целое число. Этот метод возвращает объект, который описывает допустимый диапазон для того значения.
    Отметьте, что результат только описывает минимальные и максимальные допустимые значения, и важно не читать слишком много в них. Например, могли быть значения в пределах диапазона, которые недопустимы для поля.
    Этот метод возвратит результат, поддерживает ли хронология поле.
    
    Определенный:
    
    range в class Chronology
    
    Параметры:
    
    field - поле, чтобы получить диапазон для, не нуль
    
    Возвраты:
    
    диапазон допустимых значений для поля, не нуль

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

Класс HijrahChronology

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

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

Методы, наследованные от class java.time.chrono. Хронология

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

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

ЭКЗЕМПЛЯР

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

getId

getCalendarType

дата

дата

dateYearDay

dateYearDay

dateEpochDay

dateNow

dateNow

dateNow

дата

localDateTime

zonedDateTime

zonedDateTime

isLeapYear

prolepticYear

eraOf

эры

диапазон