20230523 java.time.Duration

介绍

• java.time.Duration
• 类声明

@jdk.internal.ValueBased
public final class Duration implements TemporalAmount, Comparable<Duration>, Serializable

• 两个时刻之间的时间量

• 两个 Instant 之间的时长是 Duration

• 在内部，秒数存储在一个 long 中 (seconds)，而纳秒数存储在一个额外的 int 中 (nanos)

• Duration 是基于时间的 TemporalAmount 实现，存储秒和纳秒，但使用其他基于 Duration 的单位（例如分钟、小时和固定的 24 小时制日）提供一些访问

  • Period 是一个基于日期的 TemporalAmount 实现，存储年月日。

• 实现 TemporalAmount ， 可以获取的时间单位：

  • NANOS
  • SECONDS

• 支持换算为 日、小时、分钟、秒、毫秒、纳秒

API

常量

• ZERO : PT0S
  • 0s

static

• between

  • Duration between(Temporal startInclusive, Temporal endExclusive)

• from

  • Duration from(TemporalAmount amount)

• of

  • Duration of(long amount, TemporalUnit unit)

• ofDays

  • Duration ofDays(long days)

• ofHours

• ofMinutes

• ofSeconds

• ofMillis

• ofNanos

• parse

  • 反 toString

public

• withSeconds

  • 返回具有指定秒数的该持续时间的副本

• withNanos

  • 返回具有指定纳秒数的该持续时间的副本

• getSeconds

• getNano

• isNegative

  • 是否负值

• isZero

  • 是否 0

• truncatedTo

  • 截断

• toString

  • 返回持续时间的 ISO-8601 表示形式
  • 格式：PTnHnMnS
  • 例如 PT8H6M12.345S 表示8小时6分12.345秒

算数计算

• minus

  • 减

• minusDays

• minusHours

• minusMillis

• minusMinutes

• minusNanos

• minusSeconds

• plus

  • 加

• plusDays

• plusHours

• plusMillis

• plusMinutes

• plusNanos

• plusSeconds

• negated

  • 取负值

• abs

  • 取绝对值

• multipliedBy

  • 乘

• dividedBy

  • 除

根据时间单位获取值

• toDays
• toDaysPart
• toHours
• toHoursPart
• toMinutes
  • 换算为分钟单位
  • 例如 PT1H2M3S (1小时2分钟3秒钟) ，结果为 62
• toMinutesPart
  • 得到分钟的部分值
  • 例如 PT1H2M3S (1小时2分钟3秒钟) ，结果为 2
• toSeconds
• toSecondsPart
• toMillis
• toMillisPart
• toNanos
• toNanosPart