Java SimpleDateFormat – Формат даты Java

Введение

Классы Java SimpleDateFormat и DateFormat используются для форматирования даты. Они в основном используются там, где нам нужно отображать или использовать функциональность даты и времени в Java. Оба этих класса присутствуют в пакете com.text.

Java DateFormat

• DateFormat используется для форматирования даты в String на основе конкретной локали, которая предоставляется в качестве входных данных.
• Локаль используется для указания региона и языка, чтобы сделать код более локализованным для пользователя.
• Способ записи даты отличается в разных регионах мира. Например, 31st Dec 2017 будет записан в Индии как 31-12-2017, но то же самое будет записано в Соединенных Штатах Америки как 12-31-2017.
• Классы DateFormat не синхронизированы, рекомендуется создавать отдельный экземпляр для каждого потока.

A DateFormat object can be created using the getDateInstance() and getTimeInstance() method of the DateFormat class.

Locale loc = new Locale("en", "US");
DateFormat dateFormat = DateFormat.getDateInstance(DateFormat.DEFAULT, loc);

Locale loc = new Locale.Builder().setLanguage("en").setRegion("US").build();

Метод getDateInstance класса DateFormat требует два входных параметра. Первый параметр определяет используемый DateFormat, а второй параметр – локаль.

Использование format

Класс DateFormat имеет метод format, который отвечает за форматирование.

Locale locale = new Locale("fr", "FR");
DateFormat dateFormat = DateFormat.getDateInstance(DateFormat.DEFAULT, locale);
String date = dateFormat.format(new Date());
System.out.print(date);

Этот код отформатирует дату на французском (fr) языке и в регионе Франции (FR):

Output
3 janv. 2018

Использование getTimeInstance()

Для создания экземпляра DateFormat мы используем метод getDateInstance().

Для форматирования времени нам нужен экземпляр времени. Мы будем использовать метод getTimeInstance() для получения экземпляра времени.

Locale locale = new Locale("fr", "FR");
DateFormat dateFormat = DateFormat.getTimeInstance(DateFormat.DEFAULT, locale);
String date = dateFormat.format(new Date());
System.out.print(date);

Этот код отформатирует время на французском (fr) языке и в регионе Франции (FR):

Output
11:03:01

Java SimpleDateFormat

SimpleDateFormat похож на DateFormat. Единственное основное различие между ними заключается в том, что SimpleDateFormat можно использовать для форматирования (преобразования Date в String) и для разбора (преобразования String в Date) с поддержкой локали, тогда как у DateFormat нет поддержки локали. DateFormat является абстрактным классом, который предоставляет базовую поддержку для форматирования и разбора даты. SimpleDateFormat – это конкретный класс, который расширяет класс DateFormat.

SimpleDateFormat можно создать с использованием конструктора SimpleDateFormat. Конструктор является параметризованным и требует параметр в виде строки шаблона.

String pattern = "MM-dd-yyyy";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);

Строка pattern – это шаблон, который будет использоваться для форматирования даты, и вывод будет сгенерирован в этом шаблоне как «MM-dd-yyyy».

Шаблоны

Давайте рассмотрим синтаксис шаблона, который следует использовать для форматирования.

Некоторые буквы должны использоваться в разном количестве для получения разных результатов, например, для месяца:

Примеры

Давайте теперь посмотрим на некоторые примеры различных форматов даты и времени.

Используя SimpleDateFormat()

Чтобы разобрать дату, нам нужно создать экземпляр SimpleDateFormat с использованием конструктора, а затем использовать метод format():

String pattern = "MM-dd-yyyy";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
String date = simpleDateFormat.format(new Date());
System.out.println(date);

Этот код выведет “MM-dd-yyyy”:

Output
01-02-2018

Этот шаблон формирует “месяц в году”, “день в месяце” и “год”. Тип символа (и его написание) и количество символов вносят вклад в строку. Месяц представлен двумя цифрами, день – двумя цифрами, а год – четырьмя цифрами.

Этот код отобразил дату “2 января 2018 года” как “01-02-2018”.

Для разбора времени нам нужно изменить шаблон при создании экземпляра SimpleDateFormat.

String pattern = "HH:mm:ss.SSSZ";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
String date = simpleDateFormat.format(new Date());
System.out.println(date);

Этот код выведет “HH:mm:ss.SSSZ”:

Output
13:03:15.454+0530

Этот шаблон формирует “часы”, “минуты”, “секунды”, “миллисекунды” и “смещение часового пояса в часах (шаблон RFC)”.

Этот код отобразил время как “13:03:15.454+0530”.

Используя parse()

Разбор (парсинг) – это преобразование строки в экземпляр java.util.Date. Мы можем разобрать строку в экземпляр даты, используя метод parse() класса SimpleDateFormat. Для разбора строки в дату нам нужен экземпляр класса SimpleDateFormat и строковый шаблон в качестве входных данных для конструктора класса.

String pattern = "MM-dd-yyyy";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
Date date = simpleDateFormat.parse("12-01-2018");
System.out.println(date);

Это выведет дату (12-01-2018) без указания времени:

Output
Sat Dec 01 00:00:00 IST 2018

Теперь давайте посмотрим на пример использования SimpleDateFormat для разбора времени.

String pattern = "HH:mm:ss";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
Date date = simpleDateFormat.parse("22:00:03");
System.out.println(date);

Это выведет время (22:00:03) без указания даты:

Output
Thu Jan 01 22:00:03 IST 1970

Поскольку мы не указали дату, программа считала эпоху датой (т.е. 01-Jan-1970).

Использование Locale

Мы работали с Locale в качестве части DateFormat, и мы видели, что локали используются в зависимости от регионов.

String pattern = "EEEEE MMMMM yyyy HH:mm:ss.SSSZ";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern, new Locale("fr", "FR"));
Date date = simpleDateFormat.format(new Date());
System.out.println(date);

Этот код будет форматировать текущее время на французском языке (fr) и в регионе Франция (FR):

Output
mardi janvier 2018 14:51:02.354+0530

День и месяц названы на французском языке в зависимости от указанной локали – mardi значит “вторник”, а janvier значит “январь”.

Заключение

В этой статье вы узнали о SimpleDateFormat и DateFormat в Java.

Ссылки:

• Документация по API SimpleDateFormat
• Документация по API DateFormat