Разница между двумя датами в Java

Автор оригинала: baeldung.

1. Обзор

В этом кратком руководстве мы рассмотрим несколько возможностей вычисления разницы между двумя датами в Java.

Дальнейшее чтение:

Дата приращения в Java

Проверьте, является ли строка Допустимой датой в Java

2. Ядро Java

2.1. Использование java.util.Дата, чтобы найти разницу в днях

Давайте начнем с использования основных API Java для расчета и определения количества дней между двумя датами:

@Test
public void givenTwoDatesBeforeJava8_whenDifferentiating_thenWeGetSix()
  throws ParseException {
 
    SimpleDateFormat sdf = new SimpleDateFormat("MM/dd/yyyy", Locale.ENGLISH);
    Date firstDate = sdf.parse("06/24/2017");
    Date secondDate = sdf.parse("06/30/2017");

    long diffInMillies = Math.abs(secondDate.getTime() - firstDate.getTime());
    long diff = TimeUnit.DAYS.convert(diffInMillies, TimeUnit.MILLISECONDS);

    assertEquals(6, diff);
}

2.2. Использование java.time.temporal.Хроноунит, чтобы найти разницу

API времени в Java 8 представляет собой единицу времени данных, например, секунды или дни, используя интерфейс Temporal Unit .

Каждый блок предоставляет реализацию для метода с именем между чтобы рассчитать количество времени между двумя временными объектами в терминах этой конкретной единицы.

Например, для вычисления секунд между двумя LocalDateTime s:

@Test
public void givenTwoDateTimesInJava8_whenDifferentiatingInSeconds_thenWeGetTen() {
    LocalDateTime now = LocalDateTime.now();
    LocalDateTime tenSecondsLater = now.plusSeconds(10);

    long diff = ChronoUnit.SECONDS.between(now, tenSecondsLater);

    assertEquals(10, diff);
}

ChronoUnit предоставляет набор конкретных единиц времени, реализуя интерфейс Temporal Unit . Настоятельно рекомендуется статический импорт | ChronoUnit перечисление значений для достижения лучшей читаемости :

import static java.time.temporal.ChronoUnit.SECONDS;

// omitted
long diff = SECONDS.between(now, tenSecondsLater);

Кроме того, мы можем передать любые два совместимых временных объекта в метод between , даже ZonedDateTime .

Что замечательно в ZonedDateTime , так это то, что расчет будет работать, даже если они установлены в разных часовых поясах:

@Test
public void givenTwoZonedDateTimesInJava8_whenDifferentiating_thenWeGetSix() {
    LocalDateTime ldt = LocalDateTime.now();
    ZonedDateTime now = ldt.atZone(ZoneId.of("America/Montreal"));
    ZonedDateTime sixMinutesBehind = now
      .withZoneSameInstant(ZoneId.of("Asia/Singapore"))
      .minusMinutes(6);
    
    long diff = ChronoUnit.MINUTES.between(sixMinutesBehind, now);
    
    assertEquals(6, diff);
}

2.3. Использование java.time.temporal.Временное#пока()

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

@Test
public void givenTwoDateTimesInJava8_whenDifferentiatingInSecondsUsingUntil_thenWeGetTen() {
    LocalDateTime now = LocalDateTime.now();
    LocalDateTime tenSecondsLater = now.plusSeconds(10);

    long diff = now.until(tenSecondsLater, ChronoUnit.SECONDS);

    assertEquals(10, diff);
}

Temporal#until и TemporalUnit#between – это два разных API для одной и той же функциональности.

2.4. Использование java.time.Продолжительность и java.время.Период

В Java 8 API Time ввел два новых класса: Duration и Period .

Если мы хотим рассчитать разницу между двумя датами в зависимости от времени (час, минуты или секунды), мы можем использовать Длительность класс :

@Test
public void givenTwoDateTimesInJava8_whenDifferentiating_thenWeGetSix() {
    LocalDateTime now = LocalDateTime.now();
    LocalDateTime sixMinutesBehind = now.minusMinutes(6);

    Duration duration = Duration.between(now, sixMinutesBehind);
    long diff = Math.abs(duration.toMinutes());

    assertEquals(6, diff);
}

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

Пример быстро объяснит эту ловушку.

Давайте подсчитаем, сколько дней между двумя датами, используя класс Period :

@Test
public void givenTwoDatesInJava8_whenUsingPeriodGetDays_thenWorks()  {
    LocalDate aDate = LocalDate.of(2020, 9, 11);
    LocalDate sixDaysBehind = aDate.minusDays(6);

    Period period = Period.between(aDate, sixDaysBehind);
    int diff = Math.abs(period.getDays());

    assertEquals(6, diff);
}

Если мы проведем тест выше, он пройдет. Мы можем подумать, что класс Period удобен для решения нашей проблемы. Пока все идет хорошо.

Если этот способ работает с разницей в шесть дней, мы не сомневаемся, что он будет работать и в течение 60 дней.

Так что давайте изменим 6 в приведенном выше тесте, чтобы 60 и посмотрите, что произойдет:

@Test
public void givenTwoDatesInJava8_whenUsingPeriodGetDays_thenDoesNotWork() {
    LocalDate aDate = LocalDate.of(2020, 9, 11);
    LocalDate sixtyDaysBehind = aDate.minusDays(60);

    Period period = Period.between(aDate, sixtyDaysBehind);
    int diff = Math.abs(period.getDays());

    assertEquals(60, diff);
}

Теперь, если мы снова проведем тест, мы увидим:

java.lang.AssertionError: 
Expected :60
Actual   :29

Ой! Почему класс Period сообщил о разнице как 29 дней?

Это связано с тем, что класс Period представляет основанный на дате промежуток времени в формате “x лет, y месяцев и z дней”. Когда мы вызываем его метод getDays () , он возвращает только часть “z дней”.

Таким образом, объект period в приведенном выше тесте имеет значение “0 лет, 1 месяц и 29 дней”:

@Test
public void givenTwoDatesInJava8_whenUsingPeriod_thenWeGet0Year1Month29Days() {
    LocalDate aDate = LocalDate.of(2020, 9, 11);
    LocalDate sixtyDaysBehind = aDate.minusDays(60);
    Period period = Period.between(aDate, sixtyDaysBehind);
    int years = Math.abs(period.getYears());
    int months = Math.abs(period.getMonths());
    int days = Math.abs(period.getDays());
    assertArrayEquals(new int[] { 0, 1, 29 }, new int[] { years, months, days });
}

Если мы хотим рассчитать разницу в днях с помощью API времени Java 8, то Хроноунит.ДНИ.между() метод – это самый простой способ.

3. Внешние библиотеки

3.1. JodaTime

Мы также можем сделать относительно простую реализацию с помощью JodaTime :


    joda-time
    joda-time
    2.9.9

Вы можете получить последнюю версию Joda-time из Maven Central.

Местная дата дело:

@Test
public void givenTwoDatesInJodaTime_whenDifferentiating_thenWeGetSix() {
    org.joda.time.LocalDate now = org.joda.time.LocalDate.now();
    org.joda.time.LocalDate sixDaysBehind = now.minusDays(6);

    long diff = Math.abs(Days.daysBetween(now, sixDaysBehind).getDays());
    assertEquals(6, diff);
}

Аналогично, с LocalDateTime :

@Test
public void givenTwoDateTimesInJodaTime_whenDifferentiating_thenWeGetSix() {
    org.joda.time.LocalDateTime now = org.joda.time.LocalDateTime.now();
    org.joda.time.LocalDateTime sixMinutesBehind = now.minusMinutes(6);

    long diff = Math.abs(Minutes.minutesBetween(now, sixMinutesBehind).getMinutes());
    assertEquals(6, diff);
}

3.2. Дата 4j

Date4j также обеспечивает простую и простую реализацию, отмечая, что в этом случае нам нужно явно предоставить Часовой пояс .

Давайте начнем с зависимости Maven:


    com.darwinsys
    hirondelle-date4j
    1.5.1

Вот быстрый тест, работающий со стандартным DateTime :

@Test
public void givenTwoDatesInDate4j_whenDifferentiating_thenWeGetSix() {
    DateTime now = DateTime.now(TimeZone.getDefault());
    DateTime sixDaysBehind = now.minusDays(6);
 
    long diff = Math.abs(now.numDaysFrom(sixDaysBehind));

    assertEquals(6, diff);
}

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

В этой статье мы проиллюстрировали несколько способов вычисления разницы между датами (со временем и без времени), как в простой Java, так и с использованием внешних библиотек.