HijrahChronology (Java Platform SE 8 )

java.lang.Object
- java.time.chrono.AbstractChronology
- - java.time.chrono.HijrahChronology

All Implemented Interfaces:: Serializable， Comparable < Chronology >， Chronology

public final class HijrahChronology
extends AbstractChronology
implements Serializable

迁徙的日历是农历支持伊斯兰日历。

的hijrahchronology遵循迁徙的日历系统规则。迁徙的日历有几个变种的基础上的差异，当新月确定已经发生并在观察了。在一些版本的每个月的长度计算的算法从地球和月球的天文数据和其他一个月的长度是由新月观测确定授权。该算法基于日历的日历可以预测未来。瞄准从过去看到日历仅基于历史数据是可用的。

每个月的长度是29或30天。普通年有354天，有355天，有天。

CLDR和LDML确定变种：

Chronology ID	Calendar Type	Locale extension, see `Locale`	描述
Hijrah-umalqura	islamic-umalqura	ca-islamic-umalqura	Islamic - Umm Al-Qura calendar of Saudi Arabia

额外的变种可以通过Chronology.getAvailableChronologies()可。

例子

选择从现场使用Chronology.ofLocale(java.util.Locale)年表的基础上找到现场支持BCP 47扩展机制来请求一个特定的日历时间（“CA”）。例如,

现场现场现场=。forlanguagetag（“en-us-u-ca-islamic-umalqura”）；时辰=年表年表。oflocale（现场）；

实现要求：

这个类是不可变的和线程安全的。

Implementation Note:

每个迁徙变单独配置。每个变体的财产资源定义 ID，定义的 calendar type，日历的开始，与ISO日历的排列，和一系列的年每个月的长度。该变种在 calendars.properties文件鉴定。新的特性都是以 "calendars.hijrah."：

Property Name	Property value	描述
calendars.hijrah.{ID}	The property resource defining the `{ID}` variant	The property resource is located with the `calendars.properties` file
calendars.hijrah.{ID}.type	The calendar type	LDML defines the calendar type names

迁徙性资源是一组描述日历属性。语法定义的java.util.Properties#load(Reader)。

Property Name	Property value	描述
id	Chronology Id, for example, "Hijrah-umalqura"	The Id of the calendar in common usage
type	Calendar type, for example, "islamic-umalqura"	LDML defines the calendar types
version	Version, for example: "1.8.0_1"	The version of the Hijrah variant data
iso-start	ISO start date, formatted as `yyyy-MM-dd`, for example: "1900-04-30"	The ISO date of the first day of the minimum Hijrah year.
yyyy - a numeric 4 digit year, for example "1434"	The value is a sequence of 12 month lengths, for example: "29 30 29 30 29 30 30 30 29 30 29 29"	The lengths of the 12 months of the year separated by whitespace. A numeric year property must be present for every year without any gaps. The month lengths must be between 29-32 inclusive.

从以下版本开始：

一点八

另请参见：

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static HijrahChronology`	`INSTANCE` 在伊斯兰乌姆Qura日历沙特阿拉伯单实例。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`HijrahDate`	`date(Era era, int yearOfEra, int month, int dayOfMonth)` 从时代的迁徙日历系统的本地日期，年的时代，一年和一天的月田月。
`HijrahDate`	`date(int prolepticYear, int month, int dayOfMonth)` 从预期年迁徙日历系统的本地日期，年、月、日月。
`HijrahDate`	`date(TemporalAccessor temporal)` 从另一个时间对象在这个时间表中获得一个本地日期。
`HijrahDate`	`dateEpochDay(long epochDay)` 从时代的日子在日历系统的本地日期迁徙。
`HijrahDate`	`dateNow()` 在默认时区中从系统时钟中获得当前本地日期。
`HijrahDate`	`dateNow(Clock clock)` 从指定的时钟中获取当前本地日期。
`HijrahDate`	`dateNow(ZoneId zone)` 从指定时区中的系统时钟中获取当前本地日期。
`HijrahDate`	`dateYearDay(Era era, int yearOfEra, int dayOfYear)` 从时代的迁徙日历系统的本地日期、时代、年月日等年。
`HijrahDate`	`dateYearDay(int prolepticYear, int dayOfYear)` 从预期年日年场迁徙日历系统本地日期。
`HijrahEra`	`eraOf(int eraValue)` 从数字值创建时间顺序的对象。
`List<Era>`	`eras()` 获取时代列表的年代。
`String`	`getCalendarType()` 获取伊斯兰日历的日历类型。
`String`	`getId()` 获取时间顺序的标识。
`boolean`	`isLeapYear(long prolepticYear)` 检查指定的年份是否为一个跳跃年份。
`ChronoLocalDateTime<HijrahDate>`	`localDateTime(TemporalAccessor temporal)` 从另一个时间对象中获得这个时间表中的本地日期时间。
`int`	`prolepticYear(Era era, int yearOfEra)` 计算给定的时代，今年预期年。
`ValueRange`	`range(ChronoField field)` 获取指定字段的有效值的范围。
`HijrahDate`	`resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)` 解决 `ChronoField`值解析到日期在解析。
`ChronoZonedDateTime<HijrahDate>`	`zonedDateTime(Instant instant, ZoneId zone)` 从一个 `Instant`这一 `ChronoZonedDateTime`年表。
`ChronoZonedDateTime<HijrahDate>`	`zonedDateTime(TemporalAccessor temporal)` 得到此年表 `ChronoZonedDateTime`来自另一个时空对象。

Methods inherited from class java.time.chrono.AbstractChronology
compareTo, equals, hashCode, toString

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.time.chrono.Chronology
from, getDisplayName, period

- Field Detail
  - INSTANCE
```
public static final HijrahChronology INSTANCE
```
    在伊斯兰乌姆Qura日历沙特阿拉伯单实例。其他迁徙年表变种可以从 Chronology.getAvailableChronologies()。
- 方法详细信息
  - getId
```
public String getId()
```
    获取时间顺序的标识。
    ID唯一地标识Chronology。它可以用来查找Chronology使用AbstractChronology.of(String)。
    
    Specified by:
    
    getId 接口 Chronology
    
    结果
    
    的时间顺序号，非空
    
    另请参见：
    
    getCalendarType()
  - getCalendarType
```
public String getCalendarType()
```
    获取伊斯兰日历的日历类型。
    日历类型标识符由Unicode现场数据定义的标记语言（LDML）规范。它可以用来查找Chronology使用AbstractChronology.of(String)。
    
    Specified by:
    
    getCalendarType 接口 Chronology
    
    结果
    
    日历系统类型；如果日历有一个标准类型，则非空
    
    另请参见：
    
    getId()
  - date
```
public HijrahDate date(Era era,
                       int yearOfEra,
                       int month,
                       int dayOfMonth)
```
    从时代的迁徙日历系统的本地日期，年的时代，一年和一天的月田月。
    
    Specified by:
    
    date 接口 Chronology
    
    参数
    
    era迁徙的时代，不为空
    
    yearOfEra -时代的一年
    
    month -年月
    
    dayOfMonth -月日
    
    结果
    
    当地的迁徙日期，不为空
    
    异常
    
    DateTimeException如果无法创建日期
    
    ClassCastException -如果 era不是 HijrahEra
  - date
```
public HijrahDate date(int prolepticYear,
                       int month,
                       int dayOfMonth)
```
    从预期年迁徙日历系统的本地日期，年、月、日月。
    
    Specified by:
    
    date 接口 Chronology
    
    参数
    
    prolepticYear -预期年
    
    month -年月
    
    dayOfMonth -月日
    
    结果
    
    当地的迁徙日期，不为空
    
    异常
    
    DateTimeException如果无法创建日期
  - dateYearDay
```
public HijrahDate dateYearDay(Era era,
                              int yearOfEra,
                              int dayOfYear)
```
    从时代的迁徙日历系统的本地日期、时代、年月日等年。
    
    Specified by:
    
    dateYearDay 接口 Chronology
    
    参数
    
    era迁徙的时代，不为空
    
    yearOfEra -时代的一年
    
    去年的今天 dayOfYear -
    
    结果
    
    当地的迁徙日期，不为空
    
    异常
    
    DateTimeException如果无法创建日期
    
    ClassCastException -如果 era不是 HijrahEra
  - dateYearDay
```
public HijrahDate dateYearDay(int prolepticYear,
                              int dayOfYear)
```
    从预期年日年场迁徙日历系统本地日期。
    
    Specified by:
    
    dateYearDay 接口 Chronology
    
    参数
    
    prolepticYear -预期年
    
    dayOfYear -每年的这一天
    
    结果
    
    当地的迁徙日期，不为空
    
    异常
    
    DateTimeException如果每年的值超出范围，或如果每年的这一天的一年是无效的
  - dateEpochDay
```
public HijrahDate dateEpochDay(long epochDay)
```
    从时代的日子在日历系统的本地日期迁徙。
    
    Specified by:
    
    dateEpochDay 接口 Chronology
    
    参数
    
    时代天 epochDay -
    
    结果
    
    当地的迁徙日期，不为空
    
    异常
    
    DateTimeException如果无法创建日期
  - dateNow
```
public HijrahDate dateNow()
```
    从接口复制的描述： Chronology
    
    在默认时区中从系统时钟中获得当前本地日期。
    这将查询system clock在默认时区获取当前日期。
    
    使用这种方法将防止使用另一个时钟进行测试的能力，因为时钟是硬编码的。
    
    Specified by:
    
    dateNow 接口 Chronology
    
    结果
    
    当前本地日期使用系统时钟和默认时区，而不是空的
  - dateNow
```
public HijrahDate dateNow(ZoneId zone)
```
    从接口复制的描述： Chronology
    
    从指定时区中的系统时钟中获取当前本地日期。
    这将查询system clock获取当前日期。指定时区避免依赖于默认时区。
    
    使用这种方法将防止使用另一个时钟进行测试的能力，因为时钟是硬编码的。
    
    Specified by:
    
    dateNow 接口 Chronology
    
    参数
    
    zone -区ID使用，不为空
    
    结果
    
    当前本地日期使用系统时钟，而不是空的
  - dateNow
```
public HijrahDate dateNow(Clock clock)
```
    从接口复制的描述： Chronology
    
    从指定的时钟中获取当前本地日期。
    这将查询指定的时钟，以获得当前日期-今天。使用这种方法允许使用一个备用时钟进行测试。备用时钟可采用dependency injection。
    
    Specified by:
    
    dateNow 接口 Chronology
    
    参数
    
    clock -时钟使用，不为空
    
    结果
    
    当前本地日期，而不是空
  - date
```
public HijrahDate date(TemporalAccessor temporal)
```
    从接口复制的描述： Chronology
    
    从另一个时间对象在这个时间表中获得一个本地日期。
    这获得一个日期，在此基础上指定的时间。一个TemporalAccessor表示日期和时间信息，任意设置，本厂将以ChronoLocalDate实例。
    
    转换通常用EPOCH_DAY领域，这是标准化的日历系统。
    
    这种方法相匹配的功能接口TemporalQuery可以通过方法引用查询的签名，aChronology::date。
    
    Specified by:
    
    date 接口 Chronology
    
    参数
    
    temporal -转换时间的对象，不为空
    
    结果
    
    这个年代的当地日期，不是空的
    
    另请参见：
    
    ChronoLocalDate.from(TemporalAccessor)
  - localDateTime
```
public ChronoLocalDateTime<HijrahDate> localDateTime(TemporalAccessor temporal)
```
    从接口复制的描述： Chronology
    
    从另一个时间对象中获得这个时间表中的本地日期时间。
    这在这个时间根据指定的时间来获得一个日期时间。一个TemporalAccessor表示日期和时间信息，任意设置，本厂将以ChronoLocalDateTime实例。
    
    转换提取物结合ChronoLocalDate从时空对象的LocalTime。实现允许执行优化，如访问这些字段，这些字段相当于相关对象。结果使用这个年代。
    
    这种方法相匹配的功能接口TemporalQuery可以通过方法引用查询的签名，aChronology::localDateTime。
    
    Specified by:
    
    localDateTime 接口 Chronology
    
    参数
    
    temporal -转换时间的对象，不为空
    
    结果
    
    这个年代的本地日期时间，不是空的
    
    另请参见：
    
    ChronoLocalDateTime.from(TemporalAccessor)
  - zonedDateTime
```
public ChronoZonedDateTime<HijrahDate> zonedDateTime(TemporalAccessor temporal)
```
    从接口复制的描述： Chronology
    
    得到此年表 ChronoZonedDateTime来自另一个时空对象。
    这获得一个分区的日期时间，在此基础上指定的时间。一个TemporalAccessor表示日期和时间信息，任意设置，本厂将以ChronoZonedDateTime实例。
    
    转换将首先从时态对象获得ZoneId，回落到一个ZoneOffset如果必要。然后它会试图获得一个Instant，回落到ChronoLocalDateTime如果必要。结果将是结合ZoneId或ZoneOffset与Instant或ChronoLocalDateTime。实现被允许执行的优化如访问这些字段，相当于为相关对象。结果使用这个年代。
    
    这种方法相匹配的功能接口TemporalQuery可以通过方法引用查询的签名，aChronology::zonedDateTime。
    
    Specified by:
    
    zonedDateTime 接口 Chronology
    
    参数
    
    temporal -转换时间的对象，不为空
    
    结果
    
    这个年代的划时代的时间，不是空的
    
    另请参见：
    
    ChronoZonedDateTime.from(TemporalAccessor)
  - zonedDateTime
```
public ChronoZonedDateTime<HijrahDate> zonedDateTime(Instant instant,
                                                     ZoneId zone)
```
    从接口复制的描述： Chronology
    
    从一个 Instant这一 ChronoZonedDateTime年表。
    这获得一个分区的日期时间与指定的相同的时间。
    
    Specified by:
    
    zonedDateTime 接口 Chronology
    
    参数
    
    instant -创建日期时间的瞬间，不为空
    
    zone的时区，不空
    
    结果
    
    分区日期时间，而不是空
  - isLeapYear
```
public boolean isLeapYear(long prolepticYear)
```
    从接口复制的描述： Chronology
    检查指定的年份是否为一个跳跃年份。
    一个跨越是一年比一个更长的长度比正常。确切的意义是根据以下约束条件确定的。
    - 跨越式的一年必须意味着一年比一个非跨越式的一年长。
    - 不支持一年的概念的年代，必须返回错误的。
    Specified by:
    
    isLeapYear 接口 Chronology
    
    参数
    
    prolepticYear -检查预期的一年，距离没有验证
    
    结果
    
    如果一年是一个飞跃，那是真的
  - prolepticYear
```
public int prolepticYear(Era era,
                         int yearOfEra)
```
    从接口复制的描述： Chronology
    
    计算给定的时代，今年预期年。
    本文结合时代和年时代为单预期年场。
    
    如果时间使时代的积极利用，如JapaneseChronology然后时代的年会与时代的验证。其他的年表，验证是可选的。
    
    Specified by:
    
    prolepticYear 接口 Chronology
    
    参数
    
    era -为年表正确类型的时代，不为空
    
    yearOfEra -时代年表年
    
    结果
    
    预期年
  - eraOf
```
public HijrahEra eraOf(int eraValue)
```
    从接口复制的描述： Chronology
    
    从数字值创建时间顺序的对象。
    时代是，从概念上说，最大的划分的时间线。大多数日历系统有一个单一的时代划分的时间线分为两个时代。然而，有些人有多个时代，如一个为每个领导人的统治。确切的意义是根据以下约束条件确定的。
    
    在使用中必须1970-01-01时代价值1。后来的时代必须有更高的价值。早期时代必须有顺序较低的价值观。每个年代必须引用枚举或类似的独生子女提供的时代价值。
    
    此方法返回指定时代值的正确类型的单例时代。
    
    Specified by:
    
    eraOf 接口 Chronology
    
    参数
    
    eraValue的时代价值
    
    结果
    
    日历系统时代，不是空的
  - eras
```
public List<Era> eras()
```
    从接口复制的描述： Chronology
    
    获取时代列表的年代。
    大多数日历系统都有一个时代，在这一年内有意义。如果日历系统不支持“时代”的概念，则必须返回一个空列表。
    
    Specified by:
    
    eras 接口 Chronology
    
    结果
    
    时代的列表的年代，可能是不可改变的，而不是空的
  - range
```
public ValueRange range(ChronoField field)
```
    从接口复制的描述： Chronology
    
    获取指定字段的有效值的范围。
    所有字段可以表示为一个long整数。此方法返回一个对象，该对象描述该值的有效范围。
    
    请注意，结果只描述了最小值和最大值的有效值，重要的是不要对它们进行太多的阅读。例如，可能在字段无效的范围内的值。
    
    这种方法将返回一个结果，是否年代支持该字段。
    
    Specified by:
    
    range 接口 Chronology
    
    参数
    
    field -现场得到的范围，不为空
    
    结果
    
    字段的有效值的范围，而不是空值
  - resolveDate
```
public HijrahDate resolveDate(Map<TemporalField,Long> fieldValues,
                              ResolverStyle resolverStyle)
```
    从阶级复制的描述： AbstractChronology
    解决 ChronoField值解析到日期在解析。
    最TemporalField实现使用解决方法在现场解决。相比之下，在ChronoField类定义，只有相对的意义领域的年表。因此，ChronoField日期字段的解决在特定年代的语境。
    
    ChronoField实例都通过这种方法解决，可以在子类中重写。
    - EPOCH_DAY -如果存在的话，这是转换为日期和所有其他日期字段的日期然后对交叉检查。
    - PROLEPTIC_MONTH -如果存在的话，那么它是分裂成YEAR和MONTH_OF_YEAR。如果该模式是严格的或智能的，那么该字段是验证。
    - YEAR_OF_ERA和ERA -如果存在，那么它们组合起来形成一个YEAR。在宽松的模式，YEAR_OF_ERA范围没有验证，在智能和严格的方式是。验证范围内的所有三种模式的ERA是。如果只有YEAR_OF_ERA在场，和模式是聪明的还是宽松的，然后最后一个时代是假设。在严格的模式，没有时代的假设和YEAR_OF_ERA是原封不动。如果只有ERA是存在的，那么它是原封不动。
    - YEAR，MONTH_OF_YEAR和DAY_OF_MONTH -如果三存在，那么它们组合成一个日期。在所有三种模式，这YEAR验证。如果模式是智能或严格的，那么这个月和一天都是有效的。如果该模式是宽松的，那么日期是相结合的方式相当于创建一个日期在第一天的第一天，在要求的一年，然后添加几个月的差异，然后在天的差异。如果模式是聪明的，一个月的一天比一年的月最高，然后一个月的一天调整到一个月的最后一天。如果模式是严格的，那么三个字段必须形成一个有效的日期。
    - YEAR和DAY_OF_YEAR -如果存在，那么它们组合成一个日期。在所有三种模式，这YEAR验证。如果模式是宽松的，那么日期以相当于创建日期的第一天的方式相结合，然后添加在天的差异。如果模式是聪明的或严格的，那么这两个字段必须形成一个有效的日期。
    - YEAR，MONTH_OF_YEAR，ALIGNED_WEEK_OF_MONTH和ALIGNED_DAY_OF_WEEK_IN_MONTH -如果四存在，那么它们组合成一个日期。在所有三种模式，这YEAR验证。如果该模式是宽松的，那么日期相结合的方式相当于创建一个日期在第一天的第一天，在要求的一年，然后增加了几个月的差异，然后在几周内的差异，然后在天。如果该模式是智能或严格的，那么所有的四个字段进行了验证，他们的外部范围。日期然后以一种相当于要求的一年和一个月的第一天的日期创建日期，然后在几周和几天内添加量达到他们的价值。如果模式是严格的，还验证了日期，以检查一天和一周的调整并没有改变月份。
    - YEAR，MONTH_OF_YEAR，ALIGNED_WEEK_OF_MONTH和DAY_OF_WEEK -如果四存在，那么它们组合成一个日期。该方法是按上述年一样，在ALIGNED_DAY_OF_WEEK_IN_MONTH月份和星期。每周一次的一天调整为下一个或相同的一周，几年，几个月和几周的时间已被处理。
    - YEAR，ALIGNED_WEEK_OF_YEAR和ALIGNED_DAY_OF_WEEK_IN_YEAR -如果三存在，那么它们组合成一个日期。在所有三种模式，这YEAR验证。如果该模式是宽松的，那么日期是相结合的方式相当于创建一个日期的第一天，所要求的一年，然后添加在几周内的差异，然后在天。如果该模式是智能或严格的，那么所有的三个字段进行了验证，他们的外部范围。日期然后以相当于在请求的一年的第一天创建日期，然后在几周和几天内添加量达到他们的值。如果模式是严格的，还验证了日期，以检查一天和一周的调整并没有改变一年。
    - YEAR，ALIGNED_WEEK_OF_YEAR和DAY_OF_WEEK -如果三存在，那么它们组合成一个日期。方法如上所述，在ALIGNED_DAY_OF_WEEK_IN_YEAR年周相同。每周一次的一天调整为下一个或同一个星期一次的一周，几周和几周已经处理好了。
    默认实现是适用于大多数日历系统。如果ChronoField.YEAR_OF_ERA发现没有ChronoField.ERA然后在Chronology.eras()过去时代用。执行假设一个7天的一周，即每月的第一天有价值1，第一天的一年有价值1，而第一个月和一年总是存在。
    Specified by:
    
    resolveDate 接口 Chronology
    
    重写：
    
    resolveDate 方法重写，继承类 AbstractChronology
    
    参数
    
    fieldValues -字段值的Map，可以更新，不为空
    
    resolverStyle -解决请求的类型，不为空
    
    结果
    
    解决的日期，如果没有足够的信息来创建日期

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class HijrahChronology

Field Summary

方法摘要

Methods inherited from class java.time.chrono.AbstractChronology

Methods inherited from class java.lang.Object

Methods inherited from interface java.time.chrono.Chronology

Field Detail

INSTANCE

方法详细信息

getId

getCalendarType

date

date

dateYearDay

dateYearDay

dateEpochDay

dateNow

dateNow

dateNow

date

localDateTime

zonedDateTime

zonedDateTime

isLeapYear

prolepticYear

eraOf

eras

range

resolveDate