Перейти к основному содержимому

Период и продолжительность в Java

· 4 мин. чтения

1. Обзор

В этом кратком руководстве мы рассмотрим два новых класса для работы с датами, появившихся в Java 8: Period и Duration .

Оба класса можно использовать для представления количества времени или определения разницы между двумя датами. Основное различие между этими двумя классами заключается в том, что Period использует значения на основе даты, а Duration использует значения на основе времени.

2. Класс периода

Класс Period использует единицы год, месяц и день для представления периода времени.

Мы можем получить объект Period как разницу между двумя датами, используя метод between() :

LocalDate startDate = LocalDate.of(2015, 2, 20);
LocalDate endDate = LocalDate.of(2017, 1, 15);

Period period = Period.between(startDate, endDate);

Затем мы можем определить единицы даты периода, используя методы getYears(), getMonths(), getDays() :

LOG.info("Years:" + period.getYears() + 
" months:" + period.getMonths() +
" days:"+period.getDays());

В этом случае метод isNegative() , который возвращает true , если какая-либо из единиц отрицательна, может использоваться для определения того, выше ли endDate , чем startDate :

assertFalse(period.isNegative());

Если isNegative() возвращает false, то значение startDate предшествует значению endDate .

Другой способ создания объекта Period основан на количестве дней, месяцев, недель или лет с использованием специальных методов:

Period fromUnits = Period.of(3, 10, 10);
Period fromDays = Period.ofDays(50);
Period fromMonths = Period.ofMonths(5);
Period fromYears = Period.ofYears(10);
Period fromWeeks = Period.ofWeeks(40);

assertEquals(280, fromWeeks.getDays());

Если присутствует только одно из значений, например, с помощью метода ofDays() , тогда значение других единиц равно 0.

В случае метода ofWeeks() значение параметра используется для установки количества дней путем умножения его на 7.

Мы также можем создать объект Period , проанализировав текстовую последовательность , которая должна иметь формат «PnYnMnD»:

Period fromCharYears = Period.parse("P2Y");
assertEquals(2, fromCharYears.getYears());

Period fromCharUnits = Period.parse("P2Y3M5D");
assertEquals(5, fromCharUnits.getDays());

Значение периода может быть увеличено или уменьшено с помощью методов формы plusX() и minusX() , где X представляет единицу измерения даты:

assertEquals(56, period.plusDays(50).getDays());
assertEquals(9, period.minusMonths(2).getMonths());

3. Класс продолжительности

Класс Duration представляет интервал времени в секундах или наносекундах и лучше всего подходит для обработки более коротких промежутков времени в случаях, требующих большей точности.

Мы можем определить разницу между двумя моментами времени как объект Duration , используя метод between() :

Instant start = Instant.parse("2017-10-03T10:15:30.00Z");
Instant end = Instant.parse("2017-10-03T10:16:30.00Z");

Duration duration = Duration.between(start, end);

Затем мы можем использовать методы getSeconds() или getNanoseconds() для определения значения единиц времени:

assertEquals(60, duration.getSeconds());

В качестве альтернативы мы можем получить экземпляр Duration из двух экземпляров LocalDateTime:

LocalTime start = LocalTime.of(1, 20, 25, 1024);
LocalTime end = LocalTime.of(3, 22, 27, 1544);

Duration.between(start, end).getSeconds();

Метод isNegative() можно использовать для проверки того, выше ли конечный момент, чем начальный момент:

assertFalse(duration.isNegative());

Мы также можем получить объект Duration на основе нескольких единиц времени , используя методы ofDays(), ofHours(), ofMillis(), ofMinutes(), ofNanos(), ofSeconds() :

Duration fromDays = Duration.ofDays(1);
assertEquals(86400, fromDays.getSeconds());

Duration fromMinutes = Duration.ofMinutes(60);

Чтобы создать объект Duration на основе текстовой последовательности, она должна иметь вид «PnDTnHnMn.nS»:

Duration fromChar1 = Duration.parse("P1DT1H10M10.5S");
Duration fromChar2 = Duration.parse("PT10M");

Продолжительность может быть преобразована в другие единицы времени с помощью toDays(), toHours(), toMillis(), toMinutes() :

assertEquals(1, fromMinutes.toHours());

Значение продолжительности может быть увеличено или уменьшено с помощью методов формы plusX() или minusX() , где X может обозначать дни, часы, миллисекунды, минуты, нано или секунды:

assertEquals(120, duration.plusSeconds(60).getSeconds());     
assertEquals(30, duration.minusSeconds(30).getSeconds());

Мы также можем использовать методы plus() и minus() с параметром, который указывает TemporalUnit для добавления или вычитания:

assertEquals(120, duration.plus(60, ChronoUnit.SECONDS).getSeconds());     
assertEquals(30, duration.minus(30, ChronoUnit.SECONDS).getSeconds());

4. Вывод

В этом уроке мы показали, как мы можем использовать классы Period и Duration .

Как всегда, полный исходный код примеров можно найти на GitHub .