Расчёт дней между датами на Java: учёт високосных и летнего времени

Быстрый ответ

Чтобы определить количество дней между двумя датами, используйте метод ChronoUnit.DAYS.between(start, end):

import java.time.LocalDate;
import java.time.temporal.ChronoUnit;

long days = ChronoUnit.DAYS.between(LocalDate.of(2023, 1, 1), LocalDate.of(2023, 12, 31));
System.out.println("Дней: " + days);  // Выведет: "Дней: 364"

Таким образом, вы сможете без проблем получить точное количество календарных дней, минуя использование старого и сложного API.

Разбор процесса

Преобразование дат из строк, введенных пользователем

Для того чтобы преобразовать даты, введенные пользователем, пользуйтесь DateTimeFormatter:

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd MM yyyy");
LocalDate startDate = LocalDate.parse("01 01 2023", formatter);
LocalDate endDate = LocalDate.parse("31 12 2023", formatter);

long daysBetween = ChronoUnit.DAYS.between(startDate, endDate);
System.out.println("Дней между: " + daysBetween);  // Выведет "Дней между: 364". Дополнительного дня в связи с Новым Годом нет.

Подробнее об этом расскажет наш спикер на видео

Учет високосных годов

Вам не стоит беспокоиться о високосных годах: пакет java.time автоматически учитывает их при расчетах.

Возможные препятствия

Будьте осторожны с использованием Duration.between, которое считает 24-часовые периоды и может быть ненадежным для вычисления календарных дней из-за перехода на летнее/зимнее время. Для подсчета календарных дней всегда используйте ChronoUnit.DAYS.between.

Прохождение крайних случаев и детальная настройка

Работа с часовыми поясами

Пакет java.time обеспечивает обработку изменений в часовых поясах и в условиях перехода на летнее время. Тем не менее, для работы с конкретными часовыми поясами всегда держите под рукой ZonedDateTime или OffsetDateTime.

Исключение отрицательных значений

Воспользуйтесь Math.abs для гарантирования того, что результат всегда будет положительным:

long days = Math.abs(ChronoUnit.DAYS.between(startDate, endDate));  // Теперь отрицательное значение точно не получить.

Обработка ввода дат

Обязательно проверяйте ввод и обрабатывайте исключения:

try {
    LocalDate date = LocalDate.parse(inputString, formatter);
} catch (DateTimeParseException e) {
    System.out.println("Некорректный формат даты. Пожалуйста, используйте формат 'dd MM yyyy'.");
}

Важность выбора имен переменных

Выбирайте такие имена переменных, которые будут понятными и значимыми, например, startDate и endDate, которые способны говорить сами за себя.

Визуализация

Процесс вычисления количества дней между датами можно представить как измерение дистанции от рассвета до заката:

| Дата начала (🌅) |----------------------------------------------| Дата окончания (🌇) |

Java упрощает выполнение этой задачи:

long daysBetween = ChronoUnit.DAYS.between(startDate, endDate);

Воспринимайте ChronoUnit.DAYS.between как точную линейку, которая измеряет расстояние между датами:

🌅📏📏📏📏📏📏📏📏📏🌇 – Каждый символ 📏 представляет один день.
Количество: **daysBetween** 📅

Таким образом, Java аккуратно вычисляет количество дней между начальной и конечной датами.

Углубленное изучение

Работа со старым кодом

Если вам приходится столкнуться со старым кодом, использующим java.util.Date или SimpleDateFormat, как можно скорее преобразуйте его в последовательность LocalDate:

Date legacyDate = new ... // Ваш старый объект даты
LocalDate newStyleDate = legacyDate.toInstant().atZone(ZoneId.systemDefault()).toLocalDate();  // Добро пожаловать в новую эпоху.

Точность времени

Для работы с Instant или временными метками Duration.between() может пригодиться для большей точности, однако он не предназначен для календарных расчетов.

Точное вычисление дней

Доверяйте вычисление дней ChronoUnit.DAYS.between, чтобы учесть високосные годы и разную продолжительность месяцев — это ваш доверительный помощник для календарных вычислений.

TemporalAdjuster для сложных задач

Используйте TemporalAdjuster для выполнения сложных операций с датами, таких как поиск следующей среды или последнего дня месяца.

Полезные материалы

1. Java 8 Date – LocalDate, LocalDateTime, Instant | DigitalOcean — Изучите преимущества работы с датами в Java 8.
2. Joda-Time – Home — Joda-Time предлагает классический подход к обработке дат в Java.
3. Java SE 8 Date and Time — Детальное руководство по работе с API даты и времени в Java SE 8.
4. Trail: Date Time (The Java™ Tutorials) — Официальное руководство по работе с Time API в Java SE 8.
5. Date (Java Platform SE 7 ) — Официальная документация по классу Date до появления Java 8.