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

«1. Обзор

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

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

2. Класс Period

Класс 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 представляет интервал времени в секундах или наносекундах и лучше всего подходит для обработки более коротких промежутков времени в случаях, требующих большей точности.

Мы можем определить разницу между двумя моментами времени как объект 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, основанный на текстовой последовательности, он должен иметь форму «PnDTnHnMn.nS»:

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

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

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

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

assertEquals(1, fromMinutes.toHours());

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

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

4. Заключение

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

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

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

«