compact1, compact2, compact3

java.time.chrono

Class MinguoChronology

java.lang.Object

java.time.chrono.AbstractChronology

java.time.chrono.MinguoChronology

All Implemented Interfaces:

Serializable ， Comparable < Chronology >， Chronology

public final class MinguoChronology
extends AbstractChronology
implements Serializable

国际日历系统。

这个年表定义了Minguo日历系统的规则。 这个日历系统主要用于中华民国，通常被称为台湾。 日期对齐，使得0001-01-01 (Minguo)是1912-01-01 (ISO) 。

字段定义如下：

• 时代 - 有两个时代，现在的“共和国”（ERA_ROC）和前一个时代（ERA_BEFORE_ROC）。
• 年代 - 当代时代的年代从一年的时代起统一起来。 对于前一个时代，一年中随着时间的推移而增加。 当前时代的价值等于ISO抗体年减去1911年。
• 幼稚年份 - 幼稚年份与当今时代相同。 对于以前的时代，岁月有零，然后负值。 该值等于ISO抗精神病年减去1911年。
• 月份 - Minguo月份与ISO完全匹配。
• 月份 - Minguo日期与ISO完全匹配。
• 日期 - Minguo的日期与ISO完全一致。
• 闰年 - Minguo闰年模式与ISO完全匹配，使得两个日历永远不会失步。

实现要求：

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

从以下版本开始：

1.8

另请参见：

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static MinguoChronology	INSTANCE 孟国时代的单身人士实例。

方法摘要

Modifier and Type	Method and Description
MinguoDate	date(Era era, int yearOfEra, int month, int dayOfMonth) 从时代，年龄，月份和月份的时代，获得Minguo日历系统中的当地日期。
MinguoDate	date(int prolepticYear, int month, int dayOfMonth) 从月光年，月和月的月份中获取Minguo日历系统中的当地日期。
MinguoDate	date(TemporalAccessor temporal) 从另一个时间对象获取本年龄的本地日期。
MinguoDate	dateEpochDay(long epochDay) 从时代到日本的Minguo日历系统获取本地日期。
MinguoDate	dateNow() 从默认时区的系统时钟获取此时间顺序中的当前本地日期。
MinguoDate	dateNow(Clock clock) 从指定的时钟获取本年龄的当前本地日期。
MinguoDate	dateNow(ZoneId zone) 从指定时区的系统时钟获取此时间顺序中的当前本地日期。
MinguoDate	dateYearDay(Era era, int yearOfEra, int dayOfYear) 从时代，年龄和日期领域获得Minguo日历系统中的当地日期。
MinguoDate	dateYearDay(int prolepticYear, int dayOfYear) 从日光年和日期字段获取Minguo日历系统中的当地日期。
MinguoEra	eraOf(int eraValue) 根据数值创建年代时代对象。
List<Era>	eras() 获取年表的时间列表。
String	getCalendarType() 获取底层日历系统的日历类型 - “roc”。
String	getId() 获取年代的ID - “Minguo”。
boolean	isLeapYear(long prolepticYear) 检查指定年份是否是闰年。
ChronoLocalDateTime<MinguoDate>	localDateTime(TemporalAccessor temporal) 从另一个时间对象获取本年龄的本地日期时间。
int	prolepticYear(Era era, int yearOfEra) 计算年龄和年龄的幼年时期。
ValueRange	range(ChronoField field) 获取指定字段的有效值的范围。
MinguoDate	resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle) 解析解析时解析为 ChronoField值。
ChronoZonedDateTime<MinguoDate>	zonedDateTime(Instant instant, ZoneId zone) 获得 ChronoZonedDateTime在从这个年表 Instant 。
ChronoZonedDateTime<MinguoDate>	zonedDateTime(TemporalAccessor temporal) 从另一个时间对象获得这个 ChronoZonedDateTime中的一个 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

字段详细信息

INSTANCE

public static final MinguoChronology INSTANCE

孟国时代的单身人士实例。

方法详细信息

getId

public String getId()

获取年代的ID - “Minguo”。

该ID唯一标识Chronology 。 它可以用于查找Chronology使用AbstractChronology.of(String) 。

Specified by:

getId在界面 Chronology

结果

年表ID - 'Minguo'

另请参见：

getCalendarType()

getCalendarType

public String getCalendarType()

获取底层日历系统的日历类型 - “roc”。

日历类型是由Unicode区域设置数据标记语言（LDML）规范定义的标识符。 它可以用于查找Chronology使用AbstractChronology.of(String) 。 它也可以作为区域设置的一部分使用，通过Locale.getUnicodeLocaleType(String)可以通过键“ca”访问。

Specified by:

getCalendarType在界面 Chronology

结果

日历系统类型 - 'roc'

另请参见：

getId()

date

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

从时代，年龄，月份和月份的时代，获得Minguo日历系统中的当地日期。

Specified by:

date在接口 Chronology

参数

era - 金国时代，不为空

yearOfEra - 年代

month - 年月

dayOfMonth - 月的日子

结果

Minguo本地日期，不为null

异常

DateTimeException - 如果无法创建日期

ClassCastException - 如果 era不是 MinguoEra

date

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

从月光年，月和月的月份中获取Minguo日历系统中的当地日期。

Specified by:

date在界面 Chronology

参数

prolepticYear - 幼稚年

month - 年月

dayOfMonth - 月的日子

结果

Minguo本地日期，不为null

异常

DateTimeException - 如果无法创建日期

dateYearDay

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

从时代，年龄和日期领域获得Minguo日历系统中的当地日期。

Specified by:

dateYearDay在界面 Chronology

参数

era - 金国时代，不为空

yearOfEra - 年代

dayOfYear - 一年的一天

结果

Minguo本地日期，不为null

异常

DateTimeException - 如果无法创建日期

ClassCastException - 如果 era不是 MinguoEra

dateYearDay

public MinguoDate dateYearDay(int prolepticYear,
                              int dayOfYear)

从日光年和日期字段获取Minguo日历系统中的当地日期。

Specified by:

dateYearDay在界面 Chronology

参数

prolepticYear - 幼稚年

dayOfYear - 一年的一天

结果

Minguo本地日期，不为null

异常

DateTimeException - 如果无法创建日期

dateEpochDay

public MinguoDate dateEpochDay(long epochDay)

从时代到日本的Minguo日历系统获取本地日期。

Specified by:

dateEpochDay在接口 Chronology

参数

epochDay - 纪元日

结果

Minguo本地日期，不为null

异常

DateTimeException - 如果无法创建日期

dateNow

public MinguoDate dateNow()

说明从界面： Chronology复制

从默认时区的系统时钟获取此时间顺序中的当前本地日期。

这将查询默认时区中的system clock以获取当前日期。

使用此方法将阻止使用备用时钟进行测试，因为时钟是硬编码的。

Specified by:

dateNow在界面 Chronology

结果

当前本地日期使用系统时钟和默认时区，不为空

dateNow

public MinguoDate dateNow(ZoneId zone)

说明从界面： Chronology复制

从指定时区的系统时钟获取此时间顺序中的当前本地日期。

这将查询system clock获取当前日期。 指定时区可以避免对默认时区的依赖。

使用此方法将阻止使用备用时钟进行测试，因为时钟是硬编码的。

Specified by:

dateNow在接口 Chronology

参数

zone - 要使用的区域ID，不为空

结果

当前本地日期使用系统时钟，不为null

dateNow

public MinguoDate dateNow(Clock clock)

说明从界面： Chronology复制

从指定的时钟获取本年龄的当前本地日期。

这将查询指定的时钟以获取当前日期 - 今天。 使用此方法可以使用备用时钟进行测试。 替代时钟可以使用dependency injection引入 。

Specified by:

dateNow在界面 Chronology

参数

clock - 要使用的时钟，不为空

结果

当前本地日期，不为null

date

public MinguoDate date(TemporalAccessor temporal)

说明从界面： Chronology复制

从另一个时间对象获取本年龄的本地日期。

这在这个时间表中基于指定的时间获得日期。 A TemporalAccessor表示一个任意的日期和时间信息集，该工厂转换为ChronoLocalDate一个实例。

转换通常使用EPOCH_DAY字段，该字段在日历系统之间进行标准化。

该方法中，功能接口的签名相匹配TemporalQuery允许它被用作通过方法参考，查询aChronology::date 。

Specified by:

date在界面 Chronology

参数

temporal - 要转换的时间对象，不为null

结果

这个年代的本地日期，不为空

另请参见：

ChronoLocalDate.from(TemporalAccessor)

localDateTime

public ChronoLocalDateTime<MinguoDate> localDateTime(TemporalAccessor temporal)

说明从界面： Chronology复制

从另一个时间对象获取本年龄的本地日期时间。

这在这个时间表中基于指定的时间获得日期时间。 A TemporalAccessor表示任意的日期和时间信息集，该工厂将转换为ChronoLocalDateTime一个实例。

转换提取并结合ChronoLocalDate和LocalTime从时间对象。 允许实现执行优化，例如访问与相关对象相当的那些字段。 结果使用这个年表。

该方法中，功能接口的签名相匹配TemporalQuery允许它被用作通过方法参考，查询aChronology::localDateTime 。

Specified by:

localDateTime在接口 Chronology

参数

temporal - 要转换的时间对象，不为空

结果

在这个年代的本地日期时间，不为空

另请参见：

ChronoLocalDateTime.from(TemporalAccessor)

zonedDateTime

public ChronoZonedDateTime<MinguoDate> zonedDateTime(TemporalAccessor temporal)

说明从界面： Chronology复制

获得ChronoZonedDateTime从另一个时空对象这个年表。

根据指定的时间，在这个年表中获得一个分区的日期时间。 A TemporalAccessor表示任意的日期和时间信息集，该工厂将其转换为ChronoZonedDateTime一个实例。

转换将第一获得ZoneId从时间对象，回落到一个ZoneOffset如果必要的话。 然后，它会尝试获得Instant ，回落到ChronoLocalDateTime ，如果必要的。 结果将是ZoneId或ZoneOffset与Instant或ChronoLocalDateTime 。 允许实现执行优化，例如访问与相关对象相当的那些字段。 结果使用这个年表。

该方法中，功能接口的签名相匹配TemporalQuery允许它被用作通过方法参考，查询aChronology::zonedDateTime 。

Specified by:

zonedDateTime在界面 Chronology

参数

temporal - 要转换的时间对象，不为null

结果

在这个年代的分区日期时间，不为空

另请参见：

ChronoZonedDateTime.from(TemporalAccessor)

zonedDateTime

public ChronoZonedDateTime<MinguoDate> zonedDateTime(Instant instant,
                                                     ZoneId zone)

说明从界面： Chronology复制

获得ChronoZonedDateTime在从这个年表Instant 。

这将获得与指定的相同时间的分区日期时间。

Specified by:

zonedDateTime在接口 Chronology

参数

instant - 即时创建日期时间，不为null

zone - 时区，不为空

结果

划分的日期时间，不为空

isLeapYear

public boolean isLeapYear(long prolepticYear)

检查指定年份是否是闰年。

Minguo闰年完全符合ISO闰年。 该方法不能验证所传递的年份，并且在支持的范围内只有明确的结果多年。

Specified by:

isLeapYear在接口 Chronology

参数

prolepticYear - 检查年份，无法验证范围

结果

如果这一年是闰年，那么真的

prolepticYear

public int prolepticYear(Era era,
                         int yearOfEra)

说明从界面： Chronology复制

计算年龄和年龄的幼年时期。

这将时代与时代融为一体的年轻一代。

如果年表积极使用时代，例如JapaneseChronology那么年代将在时代得到验证。 对于其他年表，验证是可选的。

Specified by:

prolepticYear在接口 Chronology

参数

era - 正确类型的年代的时代，不为零

yearOfEra - 年代的年代

结果

幼稚的一年

eraOf

public MinguoEra 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 - 获取范围的字段，不为null

结果

字段的有效值的范围不为null

resolveDate

public MinguoDate resolveDate(Map<TemporalField,Long> fieldValues,
                              ResolverStyle resolverStyle)

描述从类别： AbstractChronology复制

解析解析后解析为ChronoField值。

大多数TemporalField实现使用该字段上的resolve方法进行解析。 相比之下， 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中的方法与上述相同，多年，数月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中已有数年ALIGNED_DAY_OF_WEEK_IN_YEAR周。 一天一周的时间一周调整为下一个或相同的匹配日期，一年的时间和周数被处理。

默认实现适用于大多数日历系统。 如果ChronoField.YEAR_OF_ERA是没有发现ChronoField.ERA然后在最后的时代Chronology.eras()使用。 实施假定为7天，第一个月的日期为1，第一天的值为1，并且月份和年份的第一个始终存在。

Specified by:

resolveDate在界面 Chronology

重写：

resolveDate在类别 AbstractChronology

参数

fieldValues - 可以更新的字段映射到值，不为null

resolverStyle - 请求的解析类型，不为null

结果

the resolved date, null if insufficient information to create a date