Класс DateFormat

public abstract class DateFormat
extends Format

DateFormat — это абстрактный класс для подклассов форматирования дат/времени, который форматирует и анализирует даты или время независимо от языка. Подкласс форматирования дат/времени, такой как SimpleDateFormat, позволяет выполнять форматирование (т.е., дата → текст), разбор (текст → дата) и нормализацию. Дата представлена как объект Date или как миллисекунды, прошедшие с 1 января 1970 года, 00:00:00 GMT.

DateFormat предоставляет множество методов класса для получения форматировщиков по умолчанию дат/времени, основанных на локале по умолчанию или заданном локале, и ряде стилей форматирования. Стили форматирования включают FULL, LONG, MEDIUM и SHORT. Более подробные сведения и примеры использования этих стилей приведены в описаниях методов.

DateFormat помогает форматировать и анализировать даты для любого локали. Ваш код может быть полностью независимым от соглашений локали для месяцев, дней недели или даже формата календаря: лунный или солнечный.

Для форматирования даты для текущего локали используйте один из статических фабричных методов:

myString = DateFormat.getDateInstance().format(myDate);

Если вы форматируете несколько дат, более эффективно получить форматировщик и использовать его несколько раз, чтобы система не должна была многократно получать информацию о соглашениях локали языка и страны.

DateFormat df = DateFormat.getDateInstance();
for (int i = 0; i < myDate.length; ++i) {
    output.println(df.format(myDate[i]) + "; ");
}

Для форматирования даты для другого локали укажите его в вызове getDateInstance().

DateFormat df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE);

Если указанный локал содержит «ca» (календарь), «rg» (переопределение региона) и/или «tz» (часовой пояс) расширения Unicode, календарь, страна и/или часовой пояс для форматирования переопределяются. Если указаны как «ca», так и «rg», календарь из расширения «ca» имеет приоритет над неявным календарём из расширения «rg».

Вы также можете использовать DateFormat для разбора.

myDate = df.parse(myString);

Используйте getDateInstance для получения обычного формата даты для этой страны. Доступны и другие статические фабричные методы. Используйте getTimeInstance для получения формата времени для этой страны. Используйте getDateTimeInstance для получения формата даты и времени. Вы можете передать различные параметры в эти фабричные методы для управления длиной результата; от SHORT до MEDIUM, до LONG до FULL. Точный результат зависит от локали, но, как правило:

• SHORT — полностью числовой, например, 12.13.52 или 3:30pm
• MEDIUM — более длинный, например, Jan 12, 1952
• LONG — более длинный, например, January 12, 1952 или 3:30:32pm
• FULL — достаточно подробно указан, например, Tuesday, April 12, 1952 AD or 3:30:42pm PST.

Вы также можете установить часовой пояс в формате, если хотите. Если вам нужен ещё больший контроль над форматированием или разбором (или вы хотите предоставить пользователям больший контроль), вы можете попробовать привести DateFormat, полученный из фабричных методов, к SimpleDateFormat. Это будет работать для большинства стран; просто помните, что необходимо поместить его в try блок на случай возникновения необычного случая.

Вы также можете использовать варианты методов parse и format с ParsePosition и FieldPosition, чтобы

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

Синхронизация

Форматы дат не синхронизированы. Рекомендуется создавать отдельные экземпляры форматировщика для каждого потока. Если несколько потоков обращаются к формату одновременно, его необходимо синхронизировать внешним образом.