- 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 描述 static MinguoChronology
INSTANCE
孟国时代的单身人士实例。
-
方法摘要
所有方法 接口方法 具体的方法 Modifier and Type 方法 描述 MinguoDate
date(int prolepticYear, int month, int dayOfMonth)
从月光年,月和月的月份中获取Minguo日历系统中的当地日期。MinguoDate
date(Era era, int yearOfEra, 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(int prolepticYear, int dayOfYear)
从日光年和日期字段获取Minguo日历系统中的当地日期。MinguoDate
dateYearDay(Era era, int yearOfEra, 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
。-
Methods inherited from class java.time.chrono.AbstractChronology
compareTo, equals, hashCode, toString
-
Methods inherited from interface java.time.chrono.Chronology
epochSecond, epochSecond, from, getDisplayName, period
-
-
-
-
字段详细信息
-
INSTANCE
public static final MinguoChronology INSTANCE
孟国时代的单身人士实例。
-
-
方法详细信息
-
getId
public String getId()
获取年代的ID - “Minguo”。该ID唯一标识了
Chronology
。 它可以用于查找Chronology
使用Chronology.of(String)
。- Specified by:
-
getId
在接口Chronology
- 结果
- 年表ID - 'Minguo'
- 另请参见:
-
getCalendarType()
-
getCalendarType
public String getCalendarType()
获取底层日历系统的日历类型 - “roc”。日历类型是由Unicode区域设置数据标记语言(LDML)规范定义的标识符。 它可用于查找
Chronology
使用Chronology.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
-prolepticYear
年 -
month
- 年月 -
dayOfMonth
- 月的日子 - 结果
- Minguo本地日期,不为null
- 异常
-
DateTimeException
- 如果无法创建日期
-
dateYearDay
public MinguoDate dateYearDay(Era era, int yearOfEra, int dayOfYear)
从时代,年龄和日期领域获得Minguo日历系统中的当地日期。- Specified by:
-
dateYearDay
在接口Chronology
- 参数
-
era
-era
时代,不为空 -
yearOfEra
- 年代 -
dayOfYear
- 年的日子 - 结果
- Minguo本地日期,不为null
- 异常
-
DateTimeException
- 如果无法创建日期 -
ClassCastException
- 如果era
不是MinguoEra
-
dateYearDay
public MinguoDate dateYearDay(int prolepticYear, int dayOfYear)
从日光年和日期字段获取Minguo日历系统中的当地日期。- Specified by:
-
dateYearDay
在接口Chronology
- 参数
-
prolepticYear
-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
复制- Specified by:
-
dateNow
在接口Chronology
- 结果
- 当前本地日期使用系统时钟和默认时区,不为空
-
dateNow
public MinguoDate dateNow(ZoneId zone)
说明从界面Chronology
复制- 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
-
-
-