系列中的上一篇
当前教程
周期和持续时间
系列中的下一篇

系列中的上一篇: 时间包

系列中的下一篇: 时钟

周期和持续时间

在编写代码以指定时间量时,请使用最符合您需求的类或方法:Duration 类、Period 类或 ChronoUnit.between() 方法。一个 Duration 使用基于时间的数值(秒、纳秒)来衡量时间量。一个 Period 使用基于日期的数值(年、月、日)。

注意:一个 Duration 的一天正好是 24 小时。一个 Period 的一天,当添加到一个 ZonedDateTime 时,可能会根据时区而有所不同。例如,如果它发生在夏令时开始或结束的那一天。

 

持续时间

一个 Duration 最适合用于衡量基于机器的时间的情况,例如使用 Instant 对象的代码。一个 Duration 对象以秒或纳秒为单位进行测量,不使用基于日期的结构,例如年、月和日,尽管该类提供了转换为天、小时和分钟的方法。一个 Duration 可以具有负值,如果它是使用在开始点之前发生的结束点创建的。

以下代码以纳秒为单位计算两个时刻之间的持续时间

Instant t1 = ...;
Instant t2 = ...;

long ns = Duration.between(t1, t2).toNanos();

以下代码将 10 秒添加到一个 Instant

Instant start= ...;

Duration gap = Duration.ofSeconds(10);
Instant later = start.plus(gap);

一个 Duration 与时间线无关,因为它不跟踪时区或夏令时。将一个相当于 1 天的 Duration 添加到一个 ZonedDateTime 会导致正好添加 24 小时,无论夏令时或其他可能导致的时间差异。

 

ChronoUnit

ChronoUnit 枚举中,在 Temporal 包中进行了讨论,定义了用于衡量时间的单位。 ChronoUnit.between() 方法在您只想用单个时间单位(例如天或秒)来衡量时间量时很有用。 between() 方法适用于所有基于时间对象,但它只返回单个单位中的数量。以下代码计算两个时间戳之间的毫秒差

Instant previous = ...;
Instant current = ...;

long gap = 0L;

current = Instant.now();
if (previous != null) {
    gap = ChronoUnit.MILLIS.between(previous,current);
}

 

周期

要使用基于日期的数值(年、月、日)定义时间量,请使用 Period 类。 Period 类提供了各种 get 方法,例如 getMonths()getDays()getYears(),以便您可以从周期中提取时间量。

总时间段由所有三个单位一起表示:月、日和年。要以单个时间单位(例如天)表示时间量,可以使用 ChronoUnit.between() 方法。

以下代码报告您的年龄,假设您出生于 1960 年 1 月 1 日。 Period 类用于确定年、月和日的时间。使用 ChronoUnit.between() 方法确定相同时间段的总天数,并以括号形式显示

LocalDate today = LocalDate.now();
LocalDate birthday = LocalDate.of(1960, Month.JANUARY, 1);

Period p = Period.between(birthday, today);
long p2 = ChronoUnit.DAYS.between(birthday, today);
System.out.println("You are " + p.getYears() + " years, " + p.getMonths() +
                   " months, and " + p.getDays() +
                   " days old. (" + p2 + " days total)");

该代码产生的输出类似于以下内容

You are 53 years, 4 months, and 29 days old. (19508 days total)

要计算到您下一个生日还有多长时间,可以使用以下代码。 Period 类用于确定月和日的值。 ChronoUnit.between() 方法返回总天数的值,并以括号形式显示。

LocalDate birthday = LocalDate.of(1960, Month.JANUARY, 1);

LocalDate nextBDay = birthday.withYear(today.getYear());

// If your birthday has occurred this year already, add 1 to the year.
if (nextBDay.isBefore(today) || nextBDay.isEqual(today)) {
    nextBDay = nextBDay.plusYears(1);
}

Period p = Period.between(today, nextBDay);
long p2 = ChronoUnit.DAYS.between(today, nextBDay);
System.out.println("There are " + p.getMonths() + " months, and " +
                   p.getDays() + " days until your next birthday. (" +
                   p2 + " total)");

该代码产生的输出类似于以下内容

There are 7 months, and 2 days until your next birthday. (216 total)

这些计算没有考虑时区差异。例如,如果您出生在澳大利亚,但目前住在班加罗尔,这会稍微影响您确切年龄的计算。在这种情况下,请将 PeriodZonedDateTime 类结合使用。当您将 Period 添加到 ZonedDateTime 时,会观察到时间差异。

在本教程中


上次更新: 2022 年 1 月 27 日


系列中的上一篇
当前教程
周期和持续时间
系列中的下一篇

系列中的上一篇: 时间包

系列中的下一篇: 时钟