20230523 java.time.temporal.TemporalAmount

介绍

• java.time.temporal.TemporalAmount
• public interface TemporalAmount
• 时间量
• 定义时间量的框架级接口
• 时间量可以被认为是 TemporalUnit 到 long 的 Map ，通过 getUnits() 和 get(TemporalUnit) 公开
• 有两种常见的实现。 Period 是一个基于日期的实现，存储年月日。 Duration 是基于时间的实现，存储秒和纳秒，但使用其他基于 Duration 的单位（例如分钟、小时和固定的 24 小时制日）提供一些访问
• 此接口是框架级接口，不应在应用程序代码中广泛使用。相反，应用程序应该创建并传递具体类型的实例，例如 Period 和 Duration

API

• get
  • long get(TemporalUnit unit);
  • 返回入参单位的值
• getUnits
  • List<TemporalUnit> getUnits();
  • 返回定义此 TemporalAmount 的单位列表
• addTo
  • Temporal addTo(Temporal temporal);
  • 推荐使用等效方法：Temporal.plus(TemporalAmount)
  • 入参时间增加时间量
• subtractFrom
  • Temporal subtractFrom(Temporal temporal);
  • 推荐使用等效方法：Temporal.minus(TemporalAmount)
  • 入参时间减去时间量