20230522 java.time.temporal.TemporalField

介绍

• java.time.temporal.TemporalField
• public interface TemporalField
• 时间域
• A field of date-time, such as month-of-year or minute-of-hour
• 日期和时间使用域来表示，这些域将时间线划分为对人类有意义的内容。此接口的实现代表这些域。
• 最常用的单位在 ChronoField 中定义。 IsoFields 、 WeekFields 和 JulianFields 中提供了更多域。应用程序代码也可以通过实现此接口来编写域
• 使用双重调度工作。客户端代码调用诸如 LocalDateTime 之类的日期时间方法，检查该域是否为 ChronoField 。如果是，则 date-time 处理它。否则，方法调用将重新调度到此接口中的匹配方法

API

default 方法

• getDisplayName
  • 获取域在请求的 Locale 中的显示名称，默认 toString()
• resolve
  • 解析此域以提供更简单的替代或日期

public 方法

域相关：

• getFrom

  • 从指定的时间对象中获取此域的值

• getBaseUnit

  • 表示域的单位
  • 域的单位是在范围（range）内变化的。例如，在“MonthOfYear”域中，单位为“月”

• getRangeUnit

  • 获取域绑定的范围
  • 在“MonthOfYear”域中，范围是“Years”

• isDateBased

  • 此域是否表示日期的组成部分

• isTimeBased

  • 此域是否表示时间的组成部分

• isSupportedBy

  • boolean isSupportedBy(TemporalAccessor temporal)
  • 日期时间对象是否支持此域

• toString

域的值相关：

• adjustInto

  • <R extends Temporal> R adjustInto(R temporal, long newValue);
  • 修改指定域的值
  • 更推荐使用等效方法，Temporal.with(TemporalField field, long newValue)

• range

  • 获取域的有效值范围

• rangeRefinedBy

  • 使用日期时间对象获取此域的有效值范围以优化结果
  • 更推荐使用等效方法，TemporalAccessor.range(TemporalField)