Відображення часу — форматування

1. Клас DateTimeFormatter

У Date Time API було додано спеціальний клас DateTimeFormatter. Його призначення — максимально полегшити перетворення дати й часу саме в той формат, який потрібен програмісту. І можна сказати, що авторам Java це вдалося.

Користуватися цим класом дуже просто. Спочатку потрібно створити об'єкт класу DateTimeFormatter і передати в нього шаблон, за яким відображатимуться дата й час:

DateTimeFormatter dtf = DateTimeFormatter.ofPattern(шаблон);

де dtf — це змінна типу DateTimeFormatter, DateTimeFormatter.ofPattern() — це статичний метод класу DateTimeFormatter, а шаблон — це рядок, що задає шаблон, за яким відображатимуться дата й час.

Приклади

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("MM-dd-yy");
String text = dtf.format( LocalDateTime.now() );
System.out.println(text);

02-22-19

У прикладі вище ми за допомогою методу ofPattern() створюємо об'єкт DateTimeFormatter на основі рядка-шаблону. А в наступному рядку за допомогою методу format() перетворюємо об'єкт типу LocalDateTime на рядок. Результат ви бачите на екрані.

У метод format() можна передати практично будь-який об'єкт із Date Time API.

Статичний метод ofPattern() теж дуже простий: отримує як параметр рядок-шаблон, а повертає об'єкт типу DateTimeFormatter. Найцікавіше міститься всередині шаблону.

2. Шаблон форматування

Рядок, переданий параметром, використовується як шаблон під час виведення інформації. MM замінюється на номер місяця, dd — на день місяця, yy — на номер року. Регістр літер має значення.

Повна таблиця перетворення часу має такий вигляд:

Взагалі, запам'ятати не складно.

А чому тоді в шаблоні з прикладу літери MM, dd та yy написані по два рази? А це вже цікавіше.

Загальна ідея

Кількість літер впливає на довжину тексту. Що більше літер, то довшим буде текст.

Якщо літеру H вказано один раз, то 9 година відображатиметься як 9, а якщо літеру H указано двічі поспіль, то 9 година відображатиметься як 09.

Якщо літеру y вказано двічі поспіль, то рік пишеться 2 цифрами, якщо 4 рази поспіль — 4-мя цифрами.

Якщо літеру M вказано двічі поспіль, то пишеться номер місяця, якщо тричі поспіль, то назва місяця (3 перші літери), якщо 4 рази поспіль, то повна назва місяця.

Приклад:

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("MMMM-dd-yyyy");
String text = dtf.format( LocalDateTime.now() );
System.out.println(text);

February-22-2019

3. Повна таблиця шаблонів

Повна таблиця досить велика й дуже цікава:

Це, до речі, ще неповний список. Повний знаходиться за посиланням:

https://docs.oracle.com/en/java/javase/13/docs/api/java.base/java/time/format/DateTimeFormatter.html

4. Парсинг часу

Клас DateTimeFormatter цікавий ще й тим, що може не тільки перетворювати дату й час на рядок за заданим шаблоном, але й виконувати зворотну операцію!

Аналіз і розбір рядка називають парсингом, від слова parse.

Отакий вигляд має цей процес:

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("MMMM-dd-yyyy", Locale.ENGLISH);
LocalDate date = LocalDate.parse("February-23-2019", dtf);
System.out.println(date);

2019-02-23

Спочатку ми створюємо об'єкт DateTimeFormatter і задаємо в ньому шаблон парсингу.

Відтак викликаємо метод LocalDate.parse() або LocalTime.parse(), або LocalDateTime.parse() і передаємо в цей метод рядок, який потрібно розпарсити, і об'єкт DateTimeFormatter, який розуміє, як і за яким шаблоном слід розпарсити переданий текст.

Ще один приклад: цього разу з парсингом часу.

DateTimeFormatter dtf = DateTimeFormatter.ofPattern("HH:mm:ss");
LocalTime time = LocalTime.parse("23:59:59", dtf);
System.out.println(time);

23:59:59