«1. Обзор
В этом руководстве вы узнаете, как реорганизовать свой код, чтобы использовать новый API Date Time, представленный в Java 8.
2. Обзор нового API
Работа с датами в Java используется быть тяжелым. Старая библиотека дат, предоставляемая JDK, включала только три класса: java.util.Date, java.util.Calendar и java.util.Timezone.
Они подходили только для самых основных задач. Для чего-то даже отдаленно сложного разработчикам приходилось либо использовать сторонние библиотеки, либо писать тонны пользовательского кода.
В Java 8 представлен совершенно новый API даты и времени (java.util.time.*), основанный на популярной библиотеке Java под названием JodaTime. Этот новый API значительно упростил обработку даты и времени и устранил многие недостатки старой библиотеки дат.
1.1. Ясность API
Первым преимуществом нового API является ясность — API очень ясен, лаконичен и прост для понимания. В ней нет многих несоответствий, найденных в старой библиотеке, таких как нумерация полей (в календаре месяцы отсчитываются от нуля, а дни недели отсчитываются от единицы).
1.2. Гибкость API
Другим преимуществом является гибкость — работа с несколькими представлениями времени. Старая библиотека дат включала только один класс представления времени — java.util.Date, который, несмотря на свое название, на самом деле является отметкой времени. Он хранит только количество миллисекунд, прошедших с эпохи Unix.
Новый API имеет множество различных представлений времени, каждое из которых подходит для разных случаев использования:
-
Instant — представляет момент времени (метку времени) LocalDate — представляет дату (год, месяц, день) LocalDateTime — представляет – то же, что и LocalDate, но включает время с точностью до наносекунды. OffsetDateTime – то же, что и LocalDateTime, но со смещением часового пояса. LocalTime – время с точностью до наносекунды и без информации о дате. ZonedDateTime – то же, что и OffsetDateTime, но включает часовой пояс. ID OffsetLocalTime — то же, что и LocalTime, но со смещением часового пояса MonthDay — месяц и день, без года и времени YearMonth — месяц и год, без дня и времени Duration — количество времени, представленное в секундах, минутах и часы. Имеет наносекундную точность Период – количество времени, представленное в днях, месяцах и годах
1.3. Неизменяемость и потокобезопасность
Другое преимущество заключается в том, что все представления времени в Java 8 Date Time API являются неизменяемыми и, следовательно, потокобезопасными.
Все изменяющие методы возвращают новую копию вместо изменения состояния исходного объекта.
Старые классы, такие как java.util.Date, не были потокобезопасными и могли привести к очень тонким ошибкам параллелизма.
1.4. Цепочка методов
Все мутирующие методы могут быть объединены в цепочку, что позволяет реализовать сложные преобразования в одной строке кода.
ZonedDateTime nextFriday = LocalDateTime.now()
.plusHours(1)
.with(TemporalAdjusters.next(DayOfWeek.FRIDAY))
.atZone(ZoneId.of("PST"));
2. Примеры
В приведенных ниже примерах показано, как выполнять общие задачи как со старым, так и с новым API.
Получение текущего времени
// Old
Date now = new Date();
// New
ZonedDateTime now = ZonedDateTime.now();
Представление конкретного времени
// Old
Date birthDay = new GregorianCalendar(1990, Calendar.DECEMBER, 15).getTime();
// New
LocalDate birthDay = LocalDate.of(1990, Month.DECEMBER, 15);
Извлечение определенных полей
// Old
int month = new GregorianCalendar().get(Calendar.MONTH);
// New
Month month = LocalDateTime.now().getMonth();
Добавление и вычитание времени
// Old
GregorianCalendar calendar = new GregorianCalendar();
calendar.add(Calendar.HOUR_OF_DAY, -5);
Date fiveHoursBefore = calendar.getTime();
// New
LocalDateTime fiveHoursBefore = LocalDateTime.now().minusHours(5);
Изменение определенных полей
// Old
GregorianCalendar calendar = new GregorianCalendar();
calendar.set(Calendar.MONTH, Calendar.JUNE);
Date inJune = calendar.getTime();
// New
LocalDateTime inJune = LocalDateTime.now().withMonth(Month.JUNE.getValue());
Усечение
Усечение сбрасывает все поля времени меньше указанного поля. В приведенном ниже примере минуты и все, что ниже, будет установлено на ноль
// Old
Calendar now = Calendar.getInstance();
now.set(Calendar.MINUTE, 0);
now.set(Calendar.SECOND, 0);
now.set(Calendar.MILLISECOND, 0);
Date truncated = now.getTime();
// New
LocalTime truncated = LocalTime.now().truncatedTo(ChronoUnit.HOURS);
Преобразование часового пояса
// Old
GregorianCalendar calendar = new GregorianCalendar();
calendar.setTimeZone(TimeZone.getTimeZone("CET"));
Date centralEastern = calendar.getTime();
// New
ZonedDateTime centralEastern = LocalDateTime.now().atZone(ZoneId.of("CET"));
Получение промежутка времени между двумя точками во времени
// Old
GregorianCalendar calendar = new GregorianCalendar();
Date now = new Date();
calendar.add(Calendar.HOUR, 1);
Date hourLater = calendar.getTime();
long elapsed = hourLater.getTime() - now.getTime();
// New
LocalDateTime now = LocalDateTime.now();
LocalDateTime hourLater = LocalDateTime.now().plusHours(1);
Duration span = Duration.between(now, hourLater);
Форматирование и анализ времени
DateTimeFormatter является заменой старого формата SimpleDateFormat, который является потокобезопасным и предоставляет дополнительные функциональные возможности.
// Old
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
Date now = new Date();
String formattedDate = dateFormat.format(now);
Date parsedDate = dateFormat.parse(formattedDate);
// New
LocalDate now = LocalDate.now();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
String formattedDate = now.format(formatter);
LocalDate parsedDate = LocalDate.parse(formattedDate, formatter);
Количество дней в месяце
// Old
Calendar calendar = new GregorianCalendar(1990, Calendar.FEBRUARY, 20);
int daysInMonth = calendar.getActualMaximum(Calendar.DAY_OF_MONTH);
// New
int daysInMonth = YearMonth.of(1990, 2).lengthOfMonth();
3. Взаимодействие с устаревшим кодом
Во многих случаях пользователю может потребоваться обеспечить совместимость со сторонними библиотеками, которые полагаются на старую библиотеку дат.
В Java 8 старые классы библиотеки дат были расширены методами, которые преобразуют их в соответствующие объекты из нового API дат. Новые классы предоставляют аналогичные функции.
Instant instantFromCalendar = GregorianCalendar.getInstance().toInstant();
ZonedDateTime zonedDateTimeFromCalendar = new GregorianCalendar().toZonedDateTime();
Date dateFromInstant = Date.from(Instant.now());
GregorianCalendar calendarFromZonedDateTime = GregorianCalendar.from(ZonedDateTime.now());
Instant instantFromDate = new Date().toInstant();
ZoneId zoneIdFromTimeZone = TimeZone.getTimeZone("PST").toZoneId();
4. Заключение
В этой статье мы рассмотрели новый API даты и времени, доступный в Java 8. Мы рассмотрели его преимущества по сравнению с устаревшим API и указали на различия на нескольких примерах.
«Обратите внимание, что мы едва коснулись возможностей нового API Date Time. Обязательно прочитайте официальную документацию, чтобы узнать о полном наборе инструментов, предлагаемых новым API.
Примеры кода можно найти в проекте GitHub.