Класс HijrahChronology

Все реализуемые интерфейсы:
Serializable, Comparable<Chronology>, Chronology 
public final class HijrahChronology
extends AbstractChronology
implements Serializable

Календарь Хиджры — лунный календарь, поддерживающий исламские календари.

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

Длительность каждого месяца составляет 29 или 30 дней. Обычные годы имеют 354 дня; високосные годы имеют 355 дней.

CLDR и LDML определяют варианты:

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

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

Пример

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

Locale locale = Locale.forLanguageTag("en-US-u-ca-islamic-umalqura");
      Chronology chrono = Chronology.ofLocale(locale);
Требования к реализации:
Этот класс неизменяем и потокобезопасен.
Примечание по реализации:
Каждый вариант Хиджры настроен индивидуально. Каждый вариант определяется ресурсом свойств, который определяет ID, calendar type, начало календаря, соответствие с календарем ISO и продолжительность каждого месяца для ряда лет. Варианты загружаются HijrahChronology в качестве ресурса из hijrah-config-<тип календаря>.properties.

Ресурс свойств Хиджры — это набор свойств, описывающих календарь. Синтаксис определен в java.util.Properties#load(Reader).

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

Краткое описание полей

Модификатор и тип Поле Описание
static HijrahChronology INSTANCE

Единственный экземпляр исламского календаря Умм аль-Куры Саудовской Аравии.

Краткое описание методов

Модификатор и тип Метод Описание
HijrahDate date​(int prolepticYear, int month, int dayOfMonth)

Получает дату местного времени в системе календаря Хиджры из полей пролептического года, месяца и числа.
HijrahDate date​(Era era, int yearOfEra, int month, int dayOfMonth)

Получает дату местного времени в системе календаря Хиджры из полей эры, года эры, месяца и числа.
HijrahDate dateEpochDay​(long epochDay)

Получает дату местного времени в системе календаря Хиджры из эпохи.
HijrahDate dateYearDay​(int prolepticYear, int dayOfYear)

Получает дату местного времени в системе календаря Хиджры из полей пролептического года и дня года.
HijrahDate dateYearDay​(Era era, int yearOfEra, int dayOfYear)

Получает дату местного времени в системе календаря Хиджры из полей эры, года эры и дня года.
HijrahEra eraOf​(int eraValue)

Создает объект HijrahEra из числового значения.
String getCalendarType()

Получает тип календаря исламского календаря.
String getId()

Получает ID хронологии.

Методы, объявленные в классе java.time.chrono.AbstractChronology

compareTo, equals, hashCode, resolveDate, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Методы, объявленные в интерфейсе java.time.chrono.Chronology

date, dateNow, dateNow, dateNow, epochSecond, epochSecond, eras, getDisplayName, isLeapYear, localDateTime, period, prolepticYear, range, zonedDateTime, zonedDateTime

Поля

INSTANCE

public static final HijrahChronology INSTANCE

Единственный экземпляр исламского календаря Умм аль-Куры Саудовской Аравии. Другие варианты хронологии хиджры могут быть доступны из Chronology.getAvailableChronologies().

Методы

getId

public String getId()

Получает идентификатор хронологии.

Идентификатор уникально определяет Chronology. Его можно использовать для поиска Chronology с помощью Chronology.of(String).

Определено в:
getId в интерфейсе Chronology
Возвращает:
идентификатор хронологии, не null
См. также:
getCalendarType()

getCalendarType

public String getCalendarType()

Получает тип календаря исламского календаря.

Тип календаря — это идентификатор, определённый спецификацией Unicode Locale Data Markup Language (LDML). Его можно использовать для поиска Chronology с помощью Chronology.of(String).

Определено в:
getCalendarType в интерфейсе Chronology
Возвращает:
тип системы календаря; не null, если календарь имеет стандартный тип, иначе null
См. также:
getId()

date

public HijrahDate date(Era era,
                       int yearOfEra,
                       int month,
                       int dayOfMonth)

Получает локальную дату в системе календаря хиджры по эпохе, году эпохи, месяцу и дню месяца.

Определено в:
date в интерфейсе Chronology
Параметры:
era — эпоха хиджры, не null
yearOfEra — год эпохи
month — месяц
dayOfMonth — день месяца
Возвращает:
локальная дата хиджры, не null
Выбрасывает:
DateTimeException — если дату создать невозможно
ClassCastException — если era не является HijrahEra

date

public HijrahDate date(int prolepticYear,
                       int month,
                       int dayOfMonth)

Получает локальную дату в системе календаря хиджры по пролептическому году, месяцу и дню месяца.

Определено в:
date в интерфейсе Chronology
Параметры:
prolepticYear — пролептический год
month — месяц
dayOfMonth — день месяца
Возвращает:
локальная дата хиджры, не null
Выбрасывает:
DateTimeException — если дату создать невозможно

dateYearDay

public HijrahDate dateYearDay(Era era,
                              int yearOfEra,
                              int dayOfYear)

Получает локальную дату в системе календаря хиджры по эпохе, году эпохи и дню года.

Определено в:
dateYearDay в интерфейсе Chronology
Параметры:
era — эпоха хиджры, не null
yearOfEra — год эпохи
dayOfYear — день года
Возвращает:
локальная дата хиджры, не null
Выбрасывает:
DateTimeException — если дату создать невозможно
ClassCastException — если era не является HijrahEra

dateYearDay

public HijrahDate dateYearDay(int prolepticYear,
                              int dayOfYear)

Получает локальную дату в системе календаря хиджры по пролептическому году и дню года.

Определено в:
dateYearDay в интерфейсе Chronology
Параметры:
prolepticYear — пролептический год
dayOfYear — день года
Возвращает:
локальная дата хиджры, не null
Выбрасывает:
DateTimeException — если значение года находится вне диапазона или день года неверен для данного года

dateEpochDay

public HijrahDate dateEpochDay(long epochDay)

Получает локальную дату в системе календаря хиджры по дню эпохи.

Определено в:
dateEpochDay в интерфейсе Chronology
Параметры:
epochDay — день эпохи
Возвращает:
локальная дата хиджры, не null
Выбрасывает:
DateTimeException — если дату создать невозможно

eraOf

public HijrahEra eraOf(int eraValue)

Создаёт объект HijrahEra из числового значения. Система календаря хиджры имеет только одну эпоху, охватывающую пролептические годы, большие нуля. Этот метод возвращает единственную эпоху HijrahEra для значения 1.

Определено в:
eraOf в интерфейсе Chronology
Параметры:
eraValue — значение эпохи
Возвращает:
эпоху системы календаря, не null
Выбрасывает:
DateTimeException — если эпоху создать невозможно

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/time/chrono/HijrahChronology.html

Spec-Zone .ru
спецификации, руководства, описания, API