«1. Обзор

В этом кратком руководстве мы обсудим LocalDate и XMLGregorianCalendar и приведем примеры преобразования между этими двумя типами.

2. XMLGregorianCalendar

Стандарт XML-схемы определяет четкие правила для указания дат в формате XML. Чтобы использовать этот формат, класс Java XMLGregorianCalendar, представленный в Java 1.5, представляет собой представление типов данных даты/времени W3C XML Schema 1.0.

3. LocalDate

Экземпляр LocalDate представляет дату без часового пояса в календарной системе ISO-8601. В результате LocalDate подходит, например, для хранения дней рождения, но не для всего, что связано со временем. Java представила LocalDate в версии 1.8.

4. Из LocalDate в XMLGregorianCalendar

Сначала мы посмотрим, как преобразовать LocalDate в XMLGregorianCalendar. Чтобы сгенерировать новый экземпляр XMLGregorianCalendar, мы используем DataTypeFactory из пакета javax.xml.datatype.

Итак, давайте создадим экземпляр LocalDate и преобразуем его в XMLGregorianCalendar:

LocalDate localDate = LocalDate.of(2019, 4, 25);

XMLGregorianCalendar xmlGregorianCalendar = 
  DatatypeFactory.newInstance().newXMLGregorianCalendar(localDate.toString());

assertThat(xmlGregorianCalendar.getYear()).isEqualTo(localDate.getYear());
assertThat(xmlGregorianCalendar.getMonth()).isEqualTo(localDate.getMonthValue());
assertThat(xmlGregorianCalendar.getDay()).isEqualTo(localDate.getDayOfMonth());
assertThat(xmlGregorianCalendar.getTimezone()).isEqualTo(DatatypeConstants.FIELD_UNDEFINED);

Как отмечалось ранее, экземпляр XMLGregorianCalendar может иметь информацию о часовом поясе. Однако LocalDate не имеет никакой информации о времени.

Поэтому, когда мы выполним преобразование, значение часового пояса останется как FIELD_UNDEFINED.

5. Из XMLGregorianCalendar в LocalDate

Теперь мы также увидим, как выполнить преобразование в обратном порядке. Как оказалось, преобразовать XMLGregorianCalendar в LocalDate намного проще.

Опять же, поскольку LocalDate не имеет информации о времени, экземпляр LocalDate может содержать только подмножество информации XMLGregorianCalendar.

Давайте создадим экземпляр XMLGregorianCalendar и выполним преобразование:

XMLGregorianCalendar xmlGregorianCalendar = 
  DatatypeFactory.newInstance().newXMLGregorianCalendar("2019-04-25");

LocalDate localDate = LocalDate.of(
  xmlGregorianCalendar.getYear(), 
  xmlGregorianCalendar.getMonth(), 
  xmlGregorianCalendar.getDay());

assertThat(localDate.getYear()).isEqualTo(xmlGregorianCalendar.getYear());
assertThat(localDate.getMonthValue()).isEqualTo(xmlGregorianCalendar.getMonth());
assertThat(localDate.getDayOfMonth()).isEqualTo(xmlGregorianCalendar.getDay());

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

В этом кратком руководстве мы рассмотрели преобразования между экземплярами LocalDate и XMLGregorianCalendar и наоборот.

И, как всегда, пример кода доступен на GitHub.