模块 java.base

包 java.time.chrono

类 JapaneseChronology

java.lang.Object

java.time.chrono.AbstractChronology

java.time.chrono.JapaneseChronology

所有已实现的接口：

Serializable , Comparable<Chronology> , Chronology

public final class JapaneseChronology extends AbstractChronology implements Serializable 
      

日本皇历系统。

该年表定义了日本皇历系统的规则。这种日历系统主要用于日本。除了基于纪元的年份编号之外，日本帝国日历系统与 ISO 日历系统相同。

日本从明治六年开始引入公历，只支持明治以后的纪元；不支持明治 6 月 1 日之前的日期。

支持的 ChronoField 实例是：

• DAY_OF_WEEK
• DAY_OF_MONTH
• DAY_OF_YEAR
• EPOCH_DAY
• MONTH_OF_YEAR
• PROLEPTIC_MONTH
• YEAR_OF_ERA
• YEAR
• ERA

实现要求：

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

自从：

1.8

参见：

• Serialized Form

字段摘要

字段

修饰符和类型	Field	描述
static final JapaneseChronology	INSTANCE	日本年表的单例实例。

方法总结

修饰符和类型	方法	描述
JapaneseDate	date(int prolepticYear, int month, int dayOfMonth)	从 proleptic-year、month-of-year 和 day-of-month 字段中获取日本日历系统中的本地日期。
JapaneseDate	date(Era era, int yearOfEra, int month, int dayOfMonth)	从时代、时代年、年月和月日字段中获取日本日历系统中的本地日期。
JapaneseDate	date(TemporalAccessor temporal)	从另一个时间对象获取此年表中的本地日期。
JapaneseDate	dateEpochDay(long epochDay)	从纪元日获取日本日历系统中的本地日期。
JapaneseDate	dateNow()	从默认时区的系统时钟获取此年表中的当前本地日期。
JapaneseDate	dateNow(Clock clock)	从指定的时钟获取此年表中的当前本地日期。
JapaneseDate	dateNow(ZoneId zone)	从指定时区的系统时钟获取此年表中的当前本地日期。
JapaneseDate	dateYearDay(int prolepticYear, int dayOfYear)	从 proleptic-year 和 day-of-year 字段中获取日本日历系统中的本地日期。
JapaneseDate	dateYearDay(Era era, int yearOfEra, int dayOfYear)	从时代、时代年份和年份字段中获取日本日历系统中的本地日期。
JapaneseEra	eraOf(int eraValue)	从给定的数值返回日历系统纪元对象。
List<Era>	eras()	获取年表的纪元列表。
String	getCalendarType()	获取基础日历系统的日历类型 - 'japanese'。
String	getId()	获取年表的 ID - 'Japanese'。
boolean	isIsoBased()	JapaneseChronology 是基于 ISO 的年表，它支持 IsoFields 中的字段，例如 DAY_OF_QUARTER 和 QUARTER_OF_YEAR 。
boolean	isLeapYear(long prolepticYear)	检查指定年份是否为闰年。
ChronoLocalDateTime<JapaneseDate>	localDateTime(TemporalAccessor temporal)	从另一个时间对象获取此年表中的本地日期时间。
int	prolepticYear(Era era, int yearOfEra)	计算给定时代和时代的预期年份。
ValueRange	range(ChronoField field)	获取指定字段的有效值范围。
JapaneseDate	resolveDate(Map<TemporalField,Long> fieldValues, ResolverStyle resolverStyle)	在解析期间将已解析的 ChronoField 值解析为日期。
ChronoZonedDateTime<JapaneseDate>	zonedDateTime(Instant instant, ZoneId zone)	从 Instant 获得此年表中的 ChronoZonedDateTime。
ChronoZonedDateTime<JapaneseDate>	zonedDateTime(TemporalAccessor temporal)	从另一个时间对象获得此年表中的 ChronoZonedDateTime。

在类 java.time.chrono.AbstractChronology 中声明的方法

compareTo, equals, hashCode, toString

在类 java.lang.Object 中声明的方法

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

在接口 java.time.chrono.Chronology 中声明的方法

epochSecond, epochSecond, getDisplayName, period

字段详细信息

INSTANCE

public static final JapaneseChronology  INSTANCE
            

日本年表的单例实例。

方法详情

getId

public String  getId()
            

获取年表的 ID - 'Japanese'。

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

指定者：

getId 在接口 Chronology 中

返回：

年表 ID - 'Japanese'

参见：

• getCalendarType()

getCalendarType

public String  getCalendarType()
            

获取基础日历系统的日历类型 - 'japanese'。

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

指定者：

getCalendarType 在接口 Chronology 中

返回：

日历系统类型 - 'japanese'

参见：

• getId()

date

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

从时代、时代年、年月和月日字段中获取日本日历系统中的本地日期。

日本的月份和日期与 ISO 日历系统中的相同。当时代改变时，它们不会被重置。例如：

 6th Jan Showa 64 = ISO 1989-01-06
 7th Jan Showa 64 = ISO 1989-01-07
 8th Jan Heisei 1 = ISO 1989-01-08
 9th Jan Heisei 1 = ISO 1989-01-09
 

指定者：

date 在接口 Chronology 中

参数：

era - 日本时代，不为空

yearOfEra - 年代

month - 月份

dayOfMonth - 每月的第几天

返回：

日本本地日期，不为空

抛出：

DateTimeException - 如果无法创建日期

ClassCastException - 如果 era 不是 JapaneseEra

date

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

从 proleptic-year、month-of-year 和 day-of-month 字段中获取日本日历系统中的本地日期。

日本的年、月、日与 ISO 日历系统中的相同。当时代改变时，它们不会被重置。

指定者：

date 在接口 Chronology 中

参数：

prolepticYear - 预兆年

month - 月份

dayOfMonth - 每月的第几天

返回：

日本本地日期，不为空

抛出：

DateTimeException - 如果无法创建日期

dateYearDay

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

从时代、时代年份和年份字段中获取日本日历系统中的本地日期。

该工厂中的年份是相对于年份开始的日期来表示的。此定义仅在由于时代变化而将时代重置为一年的那些年份中改变了一年中的一天的正常含义。例如：

 6th Jan Showa 64 = day-of-year 6
 7th Jan Showa 64 = day-of-year 7
 8th Jan Heisei 1 = day-of-year 1
 9th Jan Heisei 1 = day-of-year 2
 

指定者：

dateYearDay 在接口 Chronology 中

参数：

era - 日本时代，不为空

yearOfEra - 年代

dayOfYear - 一年中的第几天

返回：

日本本地日期，不为空

抛出：

DateTimeException - 如果无法创建日期

ClassCastException - 如果 era 不是 JapaneseEra

dateYearDay

public JapaneseDate  dateYearDay(int prolepticYear, int dayOfYear)
            

从 proleptic-year 和 day-of-year 字段中获取日本日历系统中的本地日期。

这家工厂的年份是相对于预产年的开始表示的。日本的预历年和日期与 ISO 日历系统中的相同。当时代改变时，它们不会被重置。

指定者：

dateYearDay 在接口 Chronology 中

参数：

prolepticYear - 预兆年

dayOfYear - 一年中的第几天

返回：

日本本地日期，不为空

抛出：

DateTimeException - 如果无法创建日期

dateEpochDay

public JapaneseDate  dateEpochDay(long epochDay)
            

从纪元日获取日本日历系统中的本地日期。

指定者：

dateEpochDay 在接口 Chronology 中

参数：

epochDay - 纪元日

返回：

日本本地日期，不为空

抛出：

DateTimeException - 如果无法创建日期

dateNow

public JapaneseDate  dateNow()
            

从接口 Chronology 复制的描述

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

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

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

指定者：

dateNow 在接口 Chronology 中

返回：

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

dateNow

public JapaneseDate  dateNow(ZoneId  zone)
            

从接口 Chronology 复制的描述

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

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

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

指定者：

dateNow 在接口 Chronology 中

参数：

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

返回：

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

dateNow

public JapaneseDate  dateNow(Clock  clock)
            

从接口 Chronology 复制的描述

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

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

指定者：

dateNow 在接口 Chronology 中

参数：

clock - 使用的时钟，不为空

返回：

当前本地日期，不为空

date

public JapaneseDate  date(TemporalAccessor  temporal)
            

从接口 Chronology 复制的描述

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

这将根据指定的时间获取此年表中的日期。 TemporalAccessor 表示一组任意的日期和时间信息，该工厂将其转换为 ChronoLocalDate 的一个实例。

转换通常使用跨日历系统标准化的 EPOCH_DAY 字段。

此方法与功能接口 TemporalQuery 的签名相匹配，允许它通过方法引用 aChronology::date 用作查询。

指定者：

date 在接口 Chronology 中

参数：

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

返回：

此年表中的本地日期，不为空

参见：

• ChronoLocalDate.from(TemporalAccessor)

localDateTime

public ChronoLocalDateTime <JapaneseDate > localDateTime(TemporalAccessor  temporal)
            

从接口 Chronology 复制的描述

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

这将根据指定的时间在此年表中获取日期时间。 TemporalAccessor 表示一组任意的日期和时间信息，该工厂将其转换为 ChronoLocalDateTime 的一个实例。

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

此方法与功能接口 TemporalQuery 的签名相匹配，允许它通过方法引用 aChronology::localDateTime 用作查询。

指定者：

localDateTime 在接口 Chronology 中

参数：

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

返回：

此年表中的本地日期时间，不为空

参见：

• ChronoLocalDateTime.from(TemporalAccessor)

zonedDateTime

public ChronoZonedDateTime <JapaneseDate > zonedDateTime(TemporalAccessor  temporal)
            

从接口 Chronology 复制的描述

从另一个时间对象获得此年表中的 ChronoZonedDateTime。

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

转换将首先从时间对象获取 ZoneId，必要时回落到 ZoneOffset。然后它将尝试获取 Instant ，必要时回落到 ChronoLocalDateTime 。结果将是 ZoneId 或 ZoneOffset 与 Instant 或 ChronoLocalDateTime 的组合。允许实现执行优化，例如访问与相关对象等效的那些字段。结果使用此年表。

此方法与功能接口 TemporalQuery 的签名相匹配，允许它通过方法引用 aChronology::zonedDateTime 用作查询。

指定者：

zonedDateTime 在接口 Chronology 中

参数：

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

返回：

此年表中的分区日期时间，不为空

参见：

• ChronoZonedDateTime.from(TemporalAccessor)

zonedDateTime

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

从接口 Chronology 复制的描述

从 Instant 获得此年表中的 ChronoZonedDateTime。

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

指定者：

zonedDateTime 在接口 Chronology 中

参数：

instant - 创建日期时间的时刻，不为空

zone - 时区，不为空

返回：

分区日期时间，不为空

isLeapYear

public boolean isLeapYear(long prolepticYear)
            

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

日本日历闰年与 ISO 闰年完全一致。此方法不验证传入的年份，并且只有支持范围内年份的明确定义的结果。

指定者：

isLeapYear 在接口 Chronology 中

参数：

prolepticYear - 要检查的预期年份，未针对范围进行验证

返回：

如果这一年是闰年，则为真

prolepticYear

public int prolepticYear(Era  era, int yearOfEra)
            

从接口 Chronology 复制的描述

计算给定时代和时代的预期年份。

这将时代和时代结合到单一的预测年字段。

如果年表积极使用纪元，例如 JapaneseChronology，那么纪元年将根据纪元进行验证。对于其他年表，验证是可选的。

指定者：

prolepticYear 在接口 Chronology 中

参数：

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

yearOfEra - 纪年年代

返回：

推算年份

eraOf

public JapaneseEra  eraOf(int eraValue)
            

从给定的数值返回日历系统纪元对象。该方法支持的数值与JapaneseEra.of(int) 支持的数值相同。

指定者：

eraOf 在接口 Chronology 中

参数：

eraValue - 时代值

返回：

给定数字纪元值的日语Era

抛出：

DateTimeException - 如果 eraValue 无效

eras

public List <Era > eras()
            

从接口 Chronology 复制的描述

获取年表的纪元列表。

大多数日历系统都有一个时代，其中年份具有意义。如果日历系统不支持时代的概念，则必须返回一个空列表。

指定者：

eras 在接口 Chronology 中

返回：

年表的时代列表，可能是不可变的，不为空

range

public ValueRange  range(ChronoField  field)
            

从接口 Chronology 复制的描述

获取指定字段的有效值范围。

所有字段都可以表示为一个long整数。此方法返回一个描述该值有效范围的对象。

请注意，结果仅描述了最小和最大有效值，重要的是不要过多地解读它们。例如，范围内可能存在对该字段无效的值。

无论年表是否支持该字段，此方法都会返回一个结果。

指定者：

range 在接口 Chronology 中

参数：

field - 获取范围的字段，不为空

返回：

该字段的有效值范围，不为空

resolveDate

public JapaneseDate  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 存在，并且模式是 smart 或 lenient，则假定最后一个可用时代。在严格模式下，不假定任何纪元，YEAR_OF_ERA 保持不变。如果只有 ERA 存在，则保持不变。
• YEAR 、 MONTH_OF_YEAR 和 DAY_OF_MONTH - 如果所有三个都存在，则将它们组合起来形成一个日期。在所有三种模式中，YEAR 都经过验证。如果模式是 smart 或 strict，则验证月份和日期。如果模式宽松，那么日期的组合方式相当于在所请求年份的第一个月的第一天创建一个日期，然后加上月差，然后加上天差。如果模式是智能的，并且每月的日期大于年月的最大值，则将日期调整为每月的最后一天。如果模式是严格的，那么这三个字段必须形成一个有效的日期。
• YEAR 和 DAY_OF_YEAR - 如果两者都存在，则将它们组合起来形成一个日期。在所有三种模式中，YEAR 都经过验证。如果模式宽松，则日期的组合方式相当于在请求年份的第一天创建一个日期，然后添加天数差异。如果模式是 smart 或 strict，那么这两个字段必须形成一个有效日期。
• 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，并且月份和年份的第一天始终存在。

指定者：

resolveDate 在接口 Chronology 中

重写：

resolveDate 在类 AbstractChronology 中

参数：

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

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

返回：

解决日期，如果信息不足以创建日期则为 null

isIsoBased

public boolean isIsoBased()
            

JapaneseChronology 是基于 ISO 的年表，它支持 IsoFields 中的字段，例如 DAY_OF_QUARTER 和 QUARTER_OF_YEAR 。

指定者：

isIsoBased 在接口 Chronology 中

返回：

true

自从：

19

参见：

• IsoFields