Всем привет!

Начинаем серию постов для углубления недостаточно рассмотренных и актуальных тем.

Классы для работы с датами и временем в Java Time API

Java Time API (пакет java.time) был введен в Java 8 для замены устаревших классов Date и Calendar. Он предоставляет удобные и неизменяемые (immutable) классы для работы с датами и временем.

1. LocalDate

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

Пример использования:

LocalDate today = LocalDate.now(); // Текущая дата
LocalDate specificDate = LocalDate.of(2023, 10, 15); // Конкретная дата

System.out.println("Сегодня: " + today);
System.out.println("Конкретная дата: " + specificDate);

Плюсы:
Простота использования.
Неизменяемость (immutable), что делает его потокобезопасным.

Минусы:
Не поддерживает время и временные зоны.

2. LocalTime

Класс LocalTime представляет время без даты и временной зоны. Он используется для работы с временем, например, для учета времени начала и окончания событий.

Пример использования:

LocalTime now = LocalTime.now(); // Текущее время
LocalTime specificTime = LocalTime.of(14, 30); // Конкретное время

System.out.println("Сейчас: " + now);
System.out.println("Конкретное время: " + specificTime);

Плюсы:
Удобен для работы только с временем.
Неизменяемость.

Минусы:
Не поддерживает даты и временные зоны.

3. LocalDateTime

Класс LocalDateTime объединяет LocalDate и LocalTime, представляя дату и время без временной зоны. Он используется, когда нужно работать с датой и временем одновременно.

Пример использования:

LocalDateTime now = LocalDateTime.now(); // Текущая дата и время
LocalDateTime specificDateTime = LocalDateTime.of(2023, 10, 15, 14, 30); // Конкретная дата и время

System.out.println("Сейчас: " + now);
System.out.println("Конкретная дата и время: " + specificDateTime);

Плюсы:
Удобен для работы с датой и временем.
Неизменяемость.

Минусы:
Не поддерживает временные зоны.

4. ZonedDateTime

Класс ZonedDateTime расширяет LocalDateTime, добавляя информацию о временной зоне. Он используется для работы с датой и временем в конкретной временной зоне.

Пример использования:

ZonedDateTime nowInTokyo = ZonedDateTime.now(ZoneId.of("Asia/Tokyo")); // Текущее время в Токио
ZonedDateTime specificDateTimeInNewYork = ZonedDateTime.of(2023, 10, 15, 14, 30, 0, 0, ZoneId.of("America/New_York"));

System.out.println("Сейчас в Токио: " + nowInTokyo);
System.out.println("Конкретное время в Нью-Йорке: " + specificDateTimeInNewYork);

Плюсы:
Поддержка временных зон.
Неизменяемость.

Минусы:
Сложнее в использовании из-за необходимости учитывать временные зоны.

5. Форматирование и парсинг: DateTimeFormatter

Класс DateTimeFormatter используется для форматирования и парсинга дат и времени. Он поддерживает множество предопределенных форматов, а также позволяет создавать собственные.

Пример использования:

LocalDateTime now = LocalDateTime.now();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd.MM.yyyy HH:mm:ss");

String formattedDateTime = now.format(formatter); // Форматирование
System.out.println("Форматированная дата и время: " + formattedDateTime);

LocalDateTime parsedDateTime = LocalDateTime.parse("15.10.2023 14:30:00", formatter); // Парсинг
System.out.println("Распарсенная дата и время: " + parsedDateTime);

Плюсы:
Гибкость в настройке форматов.
Поддержка локализации.

Минусы:
Требует внимательности при указании форматов, чтобы избежать ошибок.

#Java #Training #Medium #Date #LocalDate #LocalTime #LocalDateTime #ZonedDateTime #DateTimeFormatter

Форматирование и парсинг дат с DateTimeFormatter

1. Создание кастомного формата с помощью DateTimeFormatter.ofPattern()

Класс DateTimeFormatter в Java используется для форматирования и парсинга дат и времени. С помощью метода ofPattern() можно создать кастомный формат, используя специальные символы. Например:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");

В DateTimeFormatter используется множество символов для создания кастомных форматов. Вот полный список основных вариантов:

1. Год (Year)
y или yyyy — год (4 цифры). Пример: 2023.
yy — год (2 цифры). Пример: 23.
u — год в формате ISO (аналогичен y, но поддерживает отрицательные годы). Пример: 2023.

2. Месяц (Month)
M — месяц (от 1 до 12). Пример: 1, 12.
MM — месяц (2 цифры). Пример: 01, 12.
MMM — сокращенное название месяца. Пример: Jan, Dec.
MMMM — полное название месяца. Пример: January, December.

3. День (Day)
d — день месяца (от 1 до 31). Пример: 1, 31.
dd — день месяца (2 цифры). Пример: 01, 31.
D — день года (от 1 до 366). Пример: 1, 365.
F — день недели в месяце (например, 2-й понедельник). Пример: 1, 2.

4. День недели (Day of Week)
E — сокращенное название дня недели. Пример: Mon, Sun.
EEEE — полное название дня недели. Пример: Monday, Sunday.

5. Час (Hour)
H — час в 24-часовом формате (от 0 до 23). Пример: 0, 23.
HH — час в 24-часовом формате (2 цифры). Пример: 00, 23.
h — час в 12-часовом формате (от 1 до 12). Пример: 1, 12.
hh — час в 12-часовом формате (2 цифры). Пример: 01, 12.
k — час в 24-часовом формате (от 1 до 24). Пример: 1, 24.
K — час в 12-часовом формате (от 0 до 11). Пример: 0, 11.

6. Минуты (Minutes)
m — минуты (от 0 до 59). Пример: 0, 59.
mm — минуты (2 цифры). Пример: 00, 59.

7. Секунды (Seconds)
s — секунды (от 0 до 59). Пример: 0, 59.
ss — секунды (2 цифры). Пример: 00, 59.
S — доли секунды (миллисекунды, наносекунды). Пример: 0, 999.

8. Временная зона (Time Zone)
z — название временной зоны. Пример: PST, GMT+03:00.
Z — смещение временной зоны в формате +HHMM или -HHMM. Пример: +0300, -0500.
X — смещение временной зоны в формате Z, ±HH:mm, ±HHmm или ±HH. Пример: Z, +03, +0300.
O — локальное смещение временной зоны. Пример: GMT+3.

9. Период дня (AM/PM)
a — маркер периода дня (AM/PM). Пример: AM, PM.

10. Эра (Era)
G — эра (до н.э. или н.э.). Пример: AD, BC.

Примеры использования

Полный формат даты и времени:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
LocalDateTime now = LocalDateTime.now();
System.out.println(now.format(formatter)); // Пример: 2023-10-25 14:30:00

Сокращенное название месяца и дня недели:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("dd MMM yyyy, EEE");
LocalDate date = LocalDate.now();
System.out.println(date.format(formatter)); // Пример: 25 Oct 2023, Wed

Время с AM/PM:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("hh:mm:ss a");
LocalTime time = LocalTime.now();
System.out.println(time.format(formatter)); // Пример: 02:30:00 PM

Смещение временной зоны:

DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss Z");
ZonedDateTime zonedDateTime = ZonedDateTime.now();
System.out.println(zonedDateTime.format(formatter)); // Пример: 2023-10-25 14:30:00 +0300

Нюансы использования

Регистр символов: Символы в DateTimeFormatter чувствительны к регистру. Например, MM — это месяц, а mm — минуты.
Повторение символов: Количество символов влияет на формат. Например, yyyy выводит год с 4 цифрами, а yy — с 2.
Экранирование символов: Если нужно вывести символ как текст (например, T в ISO_DATE_TIME), используйте одинарные кавычки: 'T'.

#Java #Training #Medium #Date #DateTimeFormatter

2. Форматирование LocalDateTime или ZonedDateTime в строку

Чтобы отформатировать объект LocalDateTime или ZonedDateTime в строку, используйте метод format():

LocalDateTime now = LocalDateTime.now();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
String formattedDateTime = now.format(formatter);
System.out.println("Formatted DateTime: " + formattedDateTime);

Для ZonedDateTime:

ZonedDateTime zonedDateTime = ZonedDateTime.now();
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss z");
String formattedZonedDateTime = zonedDateTime.format(formatter);
System.out.println("Formatted Zoned DateTime: " + formattedZonedDateTime);

3. Парсинг строки обратно в объект

Чтобы преобразовать строку обратно в объект LocalDateTime или ZonedDateTime, используйте метод parse():
```
String dateTimeString = "2023-10-25 14:30:00";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
LocalDateTime parsedDateTime = LocalDateTime.parse(dateTimeString, formatter);
System.out.println("Parsed DateTime: " + parsedDateTime);

Для ZonedDateTime:

String zonedDateTimeString = "2023-10-25 14:30:00 Europe/Moscow";
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss z");
ZonedDateTime parsedZonedDateTime = ZonedDateTime.parse(zonedDateTimeString, formatter);
System.out.println("Parsed Zoned DateTime: " + parsedZonedDateTime);

4. Стандартные форматы в DateTimeFormatter

Java предоставляет несколько стандартных форматов, которые можно использовать без создания кастомного DateTimeFormatter:
ISO_LOCAL_DATE — формат даты без времени (например, 2023-10-25).
ISO_DATE_TIME — полный формат даты и времени с часовым поясом (например, 2023-10-25T14:30:00+03:00).
ISO_LOCAL_DATE_TIME — формат даты и времени без часового пояса (например, 2023-10-25T14:30:00).

Пример использования стандартных форматов:

LocalDateTime now = LocalDateTime.now();
String isoLocalDateTime = now.format(DateTimeFormatter.ISO_LOCAL_DATE_TIME);
System.out.println("ISO Local Date Time: " + isoLocalDateTime);

ZonedDateTime zonedNow = ZonedDateTime.now();
String isoDateTime = zonedNow.format(DateTimeFormatter.ISO_DATE_TIME);
System.out.println("ISO Date Time: " + isoDateTime);

Плюсы и минусы DateTimeFormatter

Плюсы:
Гибкость: можно создавать любые кастомные форматы.
Потокобезопасность: DateTimeFormatter является immutable и thread-safe.
Поддержка стандартных форматов.

Минусы:
Сложность: для сложных форматов требуется знание множества символов.
Ошибки парсинга: если строка не соответствует формату, будет выброшено исключение DateTimeParseException.

#Java #Training #Medium #Date #DateTimeFormatter