526互联

20230522 java.time.temporal.TemporalField

发布时间 2023-09-05 09:19:36作者: 流星<。)#)))≦

介绍

  • 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)