- 17. Java – Дата и время
- Конструкторы
- Методы класса Date
- Текущая дата и время в Java
- Сравнение дат
- Форматирование даты с помощью SimpleDateFormat
- Формат-коды SimpleDateFormat
- Форматирование даты с помощью printf
- Разница между двумя датами в Java
- 2. Ядро Java
- 2.1. Использование java.util.Date для поиска разницы в днях
- 2.2. Использование java.time.temporal.ChronoUnit для поиска различий
- 2.3. Использование временного #until()
- 2.4. Использование java.time.Duration и java.time.Period
- 3. Внешние библиотеки
- 3.1. ДжодаТайм
- 3.2. Дата4J
- 4. Вывод
17. Java – Дата и время
Java предоставляет класс Date, который доступен в пакете java.util, этот класс заключает в себе текущую дату и время.
Конструкторы
Класс Date поддерживает два конструктора, которые показаны ниже.
№ | Конструктор и описание |
1 | Date() Этот конструктор инициализирует объект с текущей датой и временем. |
2 | Date(long millisec) Этот конструктор принимает аргумент равный числу миллисекунд, истекших с полуночи 1 января 1970 г. |
Методы класса Date
Ниже представлены методы класса Date.
№ | Методы с описанием |
1 | boolean after(Date date) Возвращает значение true, если вызывающий объект date содержит дату, которая раньше заданной даты, в противном случае он возвращает значение false. |
2 | boolean before(Date date) Возвращает значение true, если вызывающий объект date содержит дату, более раннюю, чем заданная дата, в противном случае он возвращает значение false. |
3 | Object clone() Дублирование вызывающего объекта date. |
4 | int compareTo(Date date) Сравнивает значение вызывающего объекта с этой датой. Возвращает 0, если значения равны. Возвращает отрицательное значение, если объект вызова является более ранним, чем дата. Возвращает положительное значение, если объект вызова позже даты. |
5 | int compareTo(Object obj) Работает точно так же compareTo(Date), если объект вызова имеет класс Date. В противном случае вызывает ClassCastException. |
6 | boolean equals(Object date) Возвращает значение true, если вызывающий объект date содержит то же время и дату, которая указана в date, в противном случае он возвращает значение false. |
7 | long getTime() Возвращает количество миллисекунд, истекших с 1 января 1970 года. |
8 | int hashCode() Возвращает хэш-код для вызывающего объекта. |
9 | void setTime(long time) Задает дату и время, соответствующие моменту времени, что представляет собой общее затраченное время в миллисекундах от полуночи 1 января 1970 года. |
10 | String toString() Преобразует вызывающий объект date в строку и возвращает результат. |
Текущая дата и время в Java
Получить текущую дату и время в Java достаточно не трудно. Вы можете использовать простой объект date вместе с методом toString(), чтобы вывести текущую дату и время следующим образом:
import java.util.Date; public class Test < public static void main(String args[]) < // Инициализация объекта date Date date = new Date(); // Вывод текущей даты и времени с использованием toString() System.out.println(date.toString()); >>
Получим следующий результат:
Sun Nov 13 00:14:19 FET 2016
Сравнение дат
Существуют три способа в Java сравнить даты:
- Можно использовать функцию getTime(), чтобы получить количество миллисекунд, прошедших с момента полуночи 1 января 1970, для обоих объектов, а затем сравнить эти два значения.
- Вы можете использовать методы before(), after() и equals(). Поскольку 12 число месяца раньше 18 числа, например, new Date(99, 2, 12).before(new Date (99, 2, 18)) возвращает значение true.
- Можно использовать метод compareTo(), который определяется сопоставимым интерфейсом и реализуется по дате.
Форматирование даты с помощью SimpleDateFormat
SimpleDateFormat – это конкретный класс для парсинга и форматирования даты в Java. SimpleDateFormat позволяет начать с выбора любых пользовательских шаблонов для форматирования даты и времени. Например:
import java.util.*; import java.text.*; public class Test < public static void main(String args[]) < Date dateNow = new Date(); SimpleDateFormat formatForDateNow = new SimpleDateFormat("E yyyy.MM.dd 'и время' hh:mm:ss a zzz"); System.out.println("Текущая дата " + formatForDateNow.format(dateNow)); >>
Получим следующий результат:
Текущая дата Вс 2016.11.13 и время 12:12:36 AM FET
Формат-коды SimpleDateFormat
Для того, чтобы задать в Java формат даты и времени, используйте строковый шаблон (регулярные выражения) с датой и временем. В этой модели все буквы ASCII зарезервированы как шаблон письма, которые определяются следующим образом:
Символ | Описание | Пример |
G | Обозначение эры | н.э. |
y | Год из четырех цифр | 2016 |
M | Номер месяца года | 11 |
d | Число месяца | 13 |
h | Формат часа в A.M./P.M.(1~12) | 7 |
H | Формат часа(0~23) | 19 |
m | Минуты | 30 |
s | Секунды | 45 |
S | Миллисекунды | 511 |
E | День недели | Вс |
D | Номер дня в году | 318 |
F | Номер дня недели в месяце | 2 (второе воскресение в этом месяце) |
w | Номер неделя в году | 46 |
W | Номер недели в месяце | 2 |
a | Маркер A.M./P.M. | AM |
k | Формат часа(1~24) | 24 |
K | Формат часа в A.M./P.M.(0~11) | 0 |
z | Часовой пояс | FET (Дальневосточноевропейское время) |
‘ | Выделение для текста | Текст |
» | Одинарная кавычка | ‘ |
Форматирование даты с помощью printf
Формат даты и времени можно сделать без труда с помощью метода printf. Вы используете формат двух букв, начиная с t и заканчивая одним из символов в таблице, приведенных ниже. Например:
import java.util.Date; public class Test < public static void main(String args[]) < // Инициализация объекта date Date date = new Date(); // Вывод текущей даты и времени с использованием toString() String str = String.format("Текущая дата и время: %tc", date); System.out.printf(str); >>
Получим следующий результат:
Текущая дата и время: Вс ноя 13 00:55:59 FET 2016
Было бы немного глупо, если Вы должны были бы поставить дату несколько раз для форматирования каждой части. По этой причине формат строки может указывать индекс аргумента для форматирования.
Индекс должен непосредственно следовать за % и завершаться $. Например:
import java.util.Date; public class Test < public static void main(String args[]) < // Инициализация объекта date Date date = new Date(); // Вывод текущей даты с использованием toString() System.out.printf("%1$s %2$td %2$tB %2$tY", "Дата:", date); >>
Получим следующий результат:
Разница между двумя датами в Java
В этом кратком руководстве мы рассмотрим несколько возможностей вычисления разницы между двумя датами в Java.
2. Ядро Java
2.1. Использование java.util.Date для поиска разницы в днях
Давайте начнем с использования основных 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.ChronoUnit для поиска различий
API времени в Java 8 представляет единицу измерения даты и времени, например, секунды или дни, используя интерфейс TemporalUnit .
Каждый модуль предоставляет реализацию метода с именем between для вычисления количества времени между двумя темпоральными объектами в терминах этого конкретного модуля.
Например, чтобы вычислить секунды между двумя 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 предоставляет набор конкретных единиц времени путем реализации интерфейса TemporalUnit . Настоятельно рекомендуется статически импортировать значения перечисления 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. Использование временного #until()
Любой объект Temporal , такой как LocalDate или ZonedDateTime , предоставляет метод until для расчета количества времени до следующего объекта Temporal с точки зрения указанной единицы измерения :
@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.Duration и java.time.Period
В Java 8 Time API представил два новых класса: Duration и Period .
Если мы хотим вычислить разницу между двумя датами и временем в зависимости от времени (часы, минуты или секунды), мы можем использовать класс Duration :
@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 days».
Следовательно, объект периода в приведенном выше тесте содержит значение «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, метод ChronoUnit.DAYS.between() является наиболее простым способом.
3. Внешние библиотеки
3.1. ДжодаТайм
Мы также можем сделать относительно простую реализацию с JodaTime :
dependency> groupId>joda-timegroupId> artifactId>joda-timeartifactId> version>2.9.9version> dependency>
Вы можете получить последнюю версию 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 также обеспечивает прямую и простую реализацию — отмечая, что в этом случае нам нужно явно указать TimeZone .
Начнем с зависимости Maven:
dependency> groupId>com.darwinsysgroupId> artifactId>hirondelle-date4jartifactId> version>1.5.1version> dependency>
Вот быстрый тест, работающий со стандартным 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, так и с использованием внешних библиотек.
Полный исходный код статьи доступен на GitHub .