Класс DateFormat

java.lang.Object

java.text.Format

java.text.DateFormat

Все реализованные интерфейсы:: Serializable, Cloneable

Прямые известные подклассы:: SimpleDateFormat

public abstract class DateFormat extends Format

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

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

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

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

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

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

DateFormat df = DateFormat.getDateInstance();
for (Date myDate : dates) {
    output.println(df.format(myDate) + "; ");
}

Чтобы отформатировать дату для другой локали, укажите её при вызове getDateInstance().

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

Если заданная локаль содержит расширения Unicode «ca» (календарь), «rg» (переопределение региона) и/или «tz» (часовой пояс), календарь, страну и/или часовой пояс для форматирования будут переопределены. Если указаны и «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.

Для полей, содержащих текст, обычно используется сокращённая текстовая форма при параметре MEDIUM, а полная текстовая форма — при параметрах LONG и FULL.

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

Также можно использовать варианты методов разбора и форматирования с ParsePosition и FieldPosition, чтобы

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

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

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

Примечание к API:

Рассмотрите возможность использования DateTimeFormatter в качестве неизменяемой и потокобезопасной альтернативы.

Требования к реализации:

Методы format(Date, StringBuffer, FieldPosition) и parse(String, ParsePosition) могут выбросить NullPointerException, если любой из их параметров равен null. Подкласс может предоставить собственную реализацию и спецификацию для NullPointerException.
Методы setCalendar(Calendar), setNumberFormat(NumberFormat) и setTimeZone(TimeZone) не выбрасывают NullPointerException, если их параметр равен null, однако любые последующие операции с тем же экземпляром могут выбросить NullPointerException.
Методы getCalendar(), getNumberFormat() и getTimeZone() могут вернуть null, если соответствующие значения этого экземпляра заданы как null с помощью соответствующих методов установки. Например, getTimeZone() может вернуть null, если значение TimeZone этого экземпляра задано методом setTimeZone(null).

С версии:

1.1

См. также:

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`static class`	`DateFormat.Field`	Определяет константы, используемые в качестве ключей атрибутов в `AttributedCharacterIterator`, возвращаемом методом `DateFormat.formatToCharacterIterator`, а также в качестве идентификаторов полей в `FieldPosition`.

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`AM_PM_FIELD`	Полезная константа для выравнивания поля AM_PM.
`protected Calendar`	`calendar`	Экземпляр `Calendar`, используемый для вычисления полей даты и времени, а также момента времени.
`static final int`	`DATE_FIELD`	Полезная константа для выравнивания поля DATE.
`static final int`	`DAY_OF_WEEK_FIELD`	Полезная константа для выравнивания поля DAY_OF_WEEK.
`static final int`	`DAY_OF_WEEK_IN_MONTH_FIELD`	Полезная константа для выравнивания поля DAY_OF_WEEK_IN_MONTH.
`static final int`	`DAY_OF_YEAR_FIELD`	Полезная константа для выравнивания поля DAY_OF_YEAR.
`static final int`	`DEFAULT`	Константа для шаблона стиля по умолчанию.
`static final int`	`ERA_FIELD`	Полезная константа для выравнивания поля ERA.
`static final int`	`FULL`	Константа для шаблона полного стиля.
`static final int`	`HOUR_OF_DAY0_FIELD`	Полезная константа для выравнивания поля HOUR_OF_DAY с нумерацией от нуля.
`static final int`	`HOUR_OF_DAY1_FIELD`	Полезная константа для выравнивания поля HOUR_OF_DAY с нумерацией от единицы.
`static final int`	`HOUR0_FIELD`	Полезная константа для выравнивания поля HOUR с нумерацией от нуля.
`static final int`	`HOUR1_FIELD`	Полезная константа для выравнивания поля HOUR с нумерацией от единицы.
`static final int`	`LONG`	Константа для шаблона длинного стиля.
`static final int`	`MEDIUM`	Константа для шаблона среднего стиля.
`static final int`	`MILLISECOND_FIELD`	Полезная константа для выравнивания поля MILLISECOND.
`static final int`	`MINUTE_FIELD`	Полезная константа для выравнивания поля MINUTE.
`static final int`	`MONTH_FIELD`	Полезная константа для выравнивания поля MONTH.
`protected NumberFormat`	`numberFormat`	Форматировщик чисел, который `DateFormat` использует для форматирования чисел в датах и времени.
`static final int`	`SECOND_FIELD`	Полезная константа для выравнивания поля SECOND.
`static final int`	`SHORT`	Константа для шаблона короткого стиля.
`static final int`	`TIMEZONE_FIELD`	Полезная константа для выравнивания поля TIMEZONE.
`static final int`	`WEEK_OF_MONTH_FIELD`	Полезная константа для выравнивания поля WEEK_OF_MONTH.
`static final int`	`WEEK_OF_YEAR_FIELD`	Полезная константа для выравнивания поля WEEK_OF_YEAR.
`static final int`	`YEAR_FIELD`	Полезная константа для выравнивания поля YEAR.

Краткое описание конструкторов

DateFormat()

Модификатор	Конструктор	Описание
`protected`	Создаёт новый формат даты.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Переопределяет Cloneable
`boolean`	`equals(Object obj)`	Сравнивает указанный объект с этим `DateFormat` на равенство.
`final StringBuffer`	`format(Object obj, StringBuffer toAppendTo, FieldPosition fieldPosition)`	Форматирует заданный `Object` в строку даты и времени.
`final String`	`format(Date date)`	Форматирует `Date` в строку даты и времени.
`abstract StringBuffer`	`format(Date date, StringBuffer toAppendTo, FieldPosition fieldPosition)`	Форматирует `Date` в строку даты и времени.
`static Locale[]`	`getAvailableLocales()`	Возвращает массив всех локалей, для которых методы `get*Instance` этого класса могут возвращать локализованные экземпляры.
`Calendar`	`getCalendar()`	Возвращает календарь, связанный с этим форматировщиком даты и времени.
`static final DateFormat`	`getDateInstance()`	Возвращает форматировщик даты со стилем форматирования по умолчанию для локали `FORMAT` по умолчанию.
`static final DateFormat`	`getDateInstance(int style)`	Возвращает форматировщик даты с заданным стилем форматирования для локали `FORMAT` по умолчанию.
`static final DateFormat`	`getDateInstance(int style, Locale aLocale)`	Возвращает форматировщик даты с заданным стилем форматирования для указанной локали.
`static final DateFormat`	`getDateTimeInstance()`	Возвращает форматировщик даты и времени со стилем форматирования по умолчанию для локали `FORMAT` по умолчанию.
`static final DateFormat`	`getDateTimeInstance(int dateStyle, int timeStyle)`	Возвращает форматировщик даты и времени с заданными стилями форматирования даты и времени для локали `FORMAT` по умолчанию.
`static final DateFormat`	`getDateTimeInstance(int dateStyle, int timeStyle, Locale aLocale)`	Возвращает форматировщик даты и времени с заданными стилями форматирования для указанной локали.
`static final DateFormat`	`getInstance()`	Возвращает форматировщик даты и времени по умолчанию, использующий стиль SHORT как для даты, так и для времени.
`NumberFormat`	`getNumberFormat()`	Возвращает форматировщик чисел, который этот форматировщик даты и времени использует для форматирования и разбора времени.
`static final DateFormat`	`getTimeInstance()`	Возвращает форматировщик времени со стилем форматирования по умолчанию для локали `FORMAT` по умолчанию.
`static final DateFormat`	`getTimeInstance(int style)`	Возвращает форматировщик времени с заданным стилем форматирования для локали `FORMAT` по умолчанию.
`static final DateFormat`	`getTimeInstance(int style, Locale aLocale)`	Возвращает форматировщик времени с заданным стилем форматирования для указанной локали.
`TimeZone`	`getTimeZone()`	Возвращает часовой пояс.
`int`	`hashCode()`	Возвращает хеш-код этого `DateFormat`.
`boolean`	`isLenient()`	Проверяет, выполняется ли разбор даты и времени в нестрогом режиме.
`Date`	`parse(String source)`	Разбирает текст, начиная с начала заданной строки, чтобы получить дату.
`abstract Date`	`parse(String source, ParsePosition pos)`	Разбирает строку даты и времени с учётом заданной позиции разбора.
`Object`	`parseObject(String source, ParsePosition pos)`	Разбирает текст строки, чтобы получить `Date`.
`void`	`setCalendar(Calendar newCalendar)`	Задаёт календарь, используемый этим форматом даты.
`void`	`setLenient(boolean lenient)`	Указывает, должен ли разбор даты и времени выполняться в нестрогом режиме.
`void`	`setNumberFormat(NumberFormat newNumberFormat)`	Позволяет задать форматировщик чисел.
`void`	`setTimeZone(TimeZone zone)`	Задаёт часовой пояс для календаря этого объекта `DateFormat`.

Методы, объявленные в классе Format

format, formatToCharacterIterator, parseObject

Модификатор и тип	Метод	Описание
`final String`	`format(Object obj)`	Форматирует объект, создавая строку.
`AttributedCharacterIterator`	`formatToCharacterIterator(Object obj)`	Форматирует объект, создавая `AttributedCharacterIterator`.
`Object`	`parseObject(String source)`	Разбирает текст, начиная с начала заданной строки, чтобы получить объект.

Методы, объявленные в классе Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Метод завершения объявлен устаревшим и может быть удалён в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание полей

calendar

protected Calendar calendar

Экземпляр Calendar, используемый для вычисления полей даты и времени, а также момента времени. Это поле используется как для форматирования, так и для анализа.

Подклассы должны инициализировать это поле объектом Calendar, подходящим для Locale, связанного с этим DateFormat.

numberFormat

protected NumberFormat numberFormat

Форматировщик чисел, который DateFormat использует для форматирования чисел в датах и времени. Подклассы должны инициализировать это поле форматировщиком чисел, подходящим для локали, связанной с этим DateFormat.

ERA_FIELD

public static final int ERA_FIELD

Полезная константа для выравнивания поля ERA. Используется в FieldPosition при форматировании даты и времени.

См. также:

YEAR_FIELD

public static final int YEAR_FIELD

Полезная константа для выравнивания поля YEAR. Используется в FieldPosition при форматировании даты и времени.

См. также:

MONTH_FIELD

public static final int MONTH_FIELD

Полезная константа для выравнивания поля MONTH. Используется в FieldPosition при форматировании даты и времени.

См. также:

DATE_FIELD

public static final int DATE_FIELD

Полезная константа для выравнивания поля DATE. Используется в FieldPosition при форматировании даты и времени.

См. также:

HOUR_OF_DAY1_FIELD

public static final int HOUR_OF_DAY1_FIELD

Полезная константа для выравнивания поля HOUR_OF_DAY с отсчётом от единицы. Используется в FieldPosition при форматировании даты и времени. HOUR_OF_DAY1_FIELD используется для 24-часового формата с отсчётом от единицы. Например, 23:59 + 01:00 даёт 24:59.

См. также:

HOUR_OF_DAY0_FIELD

public static final int HOUR_OF_DAY0_FIELD

Полезная константа для выравнивания поля HOUR_OF_DAY с отсчётом от нуля. Используется в FieldPosition при форматировании даты и времени. HOUR_OF_DAY0_FIELD используется для 24-часового формата с отсчётом от нуля. Например, 23:59 + 01:00 даёт 00:59.

См. также:

MINUTE_FIELD

public static final int MINUTE_FIELD

Полезная константа для выравнивания поля MINUTE. Используется в FieldPosition при форматировании даты и времени.

См. также:

SECOND_FIELD

public static final int SECOND_FIELD

Полезная константа для выравнивания поля SECOND. Используется в FieldPosition при форматировании даты и времени.

См. также:

MILLISECOND_FIELD

public static final int MILLISECOND_FIELD

Полезная константа для выравнивания поля MILLISECOND. Используется в FieldPosition при форматировании даты и времени.

См. также:

DAY_OF_WEEK_FIELD

public static final int DAY_OF_WEEK_FIELD

Полезная константа для выравнивания поля DAY_OF_WEEK. Используется в FieldPosition при форматировании даты и времени.

См. также:

DAY_OF_YEAR_FIELD

public static final int DAY_OF_YEAR_FIELD

Полезная константа для выравнивания поля DAY_OF_YEAR. Используется в FieldPosition при форматировании даты и времени.

См. также:

DAY_OF_WEEK_IN_MONTH_FIELD

public static final int DAY_OF_WEEK_IN_MONTH_FIELD

Полезная константа для выравнивания поля DAY_OF_WEEK_IN_MONTH. Используется в FieldPosition при форматировании даты и времени.

См. также:

WEEK_OF_YEAR_FIELD

public static final int WEEK_OF_YEAR_FIELD

Полезная константа для выравнивания поля WEEK_OF_YEAR. Используется в FieldPosition при форматировании даты и времени.

См. также:

WEEK_OF_MONTH_FIELD

public static final int WEEK_OF_MONTH_FIELD

Полезная константа для выравнивания поля WEEK_OF_MONTH. Используется в FieldPosition при форматировании даты и времени.

См. также:

AM_PM_FIELD

public static final int AM_PM_FIELD

Полезная константа для выравнивания поля AM_PM. Используется в FieldPosition при форматировании даты и времени.

См. также:

HOUR1_FIELD

public static final int HOUR1_FIELD

Полезная константа для выравнивания поля HOUR с отсчётом от единицы. Используется в FieldPosition при форматировании даты и времени. HOUR1_FIELD используется для 12-часового формата с отсчётом от единицы. Например, 11:30 PM + 1 час даёт 12:30 AM.

См. также:

HOUR0_FIELD

public static final int HOUR0_FIELD

Полезная константа для выравнивания поля HOUR с отсчётом от нуля. Используется в FieldPosition при форматировании даты и времени. HOUR0_FIELD используется для 12-часового формата с отсчётом от нуля. Например, 11:30 PM + 1 час даёт 00:30 AM.

См. также:

TIMEZONE_FIELD

public static final int TIMEZONE_FIELD

Полезная константа для выравнивания поля TIMEZONE. Используется в FieldPosition при форматировании даты и времени.

См. также:

FULL

public static final int FULL

Константа для шаблона полного формата.

См. также:

LONG

public static final int LONG

Константа для шаблона длинного формата.

См. также:

MEDIUM

public static final int MEDIUM

Константа для шаблона среднего формата.

См. также:

SHORT

public static final int SHORT

Константа для шаблона короткого формата.

См. также:

DEFAULT

public static final int DEFAULT

Константа для шаблона формата по умолчанию. Её значение — MEDIUM.

См. также:

Подробное описание конструкторов

DateFormat

protected DateFormat()

Создаёт новый формат даты.

Подробное описание методов

format

public final StringBuffer format(Object obj, StringBuffer toAppendTo, FieldPosition fieldPosition)

Форматирует указанный Object в строку даты и времени. Отформатированная строка добавляется в указанный StringBuffer.

Определено в:

format в классе Format

Параметры:

obj — должен быть Date или Number, представляющим смещение в миллисекундах относительно эпохи.

toAppendTo — буфер строки для результирующей строки даты и времени.

fieldPosition — отслеживает положение поля в возвращаемой строке. Например, если задан текст даты и времени "1996.07.10 AD at 15:08:56 PDT", а указанный fieldPosition — это YEAR_FIELD, начальный и конечный индексы fieldPosition будут равны 0 и 4 соответственно. Обратите внимание: если одно и то же поле даты и времени встречается в шаблоне несколько раз, fieldPosition будет установлен для первого вхождения этого поля даты и времени. Например, при форматировании Date в строку даты и времени "1 PM PDT (Pacific Daylight Time)" с использованием шаблона "h a z (zzzz)" и поля выравнивания TIMEZONE_FIELD начальный и конечный индексы fieldPosition будут равны 5 и 8 соответственно для первого вхождения символа шаблона часового пояса 'z'.

Возвращает:

переданный буфер строки toAppendTo с добавленным отформатированным текстом.

Вызывает:

IllegalArgumentException — если Format не может отформатировать указанный obj.

См. также:

format

public abstract StringBuffer format(Date date, StringBuffer toAppendTo, FieldPosition fieldPosition)

Форматирует Date в строку даты и времени. Отформатированная строка добавляется в указанный StringBuffer.

Параметры:: date — объект Date, который необходимо отформатировать в строку даты и времени.; toAppendTo — буфер строки для результирующей строки даты и времени.; fieldPosition — отслеживает положение поля в возвращаемой строке. Например, если задан текст даты и времени "1996.07.10 AD at 15:08:56 PDT", а указанный fieldPosition — это YEAR_FIELD, начальный и конечный индексы fieldPosition будут равны 0 и 4 соответственно. Обратите внимание: если одно и то же поле даты и времени встречается в шаблоне несколько раз, fieldPosition будет установлен для первого вхождения этого поля даты и времени. Например, при форматировании Date в строку даты и времени "1 PM PDT (Pacific Daylight Time)" с использованием шаблона "h a z (zzzz)" и поля выравнивания TIMEZONE_FIELD начальный и конечный индексы fieldPosition будут равны 5 и 8 соответственно для первого вхождения символа шаблона часового пояса 'z'.
Возвращает:: переданный буфер строки toAppendTo с добавленным отформатированным текстом.

format

public final String format(Date date)

Форматирует Date в строку даты и времени.

Параметры:: date — значение времени, которое необходимо отформатировать в строку даты и времени.
Возвращает:: отформатированную строку даты и времени.

parse

public Date parse(String source) throws ParseException

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

Дополнительные сведения об анализе дат см. в методе parse(String, ParsePosition).

Параметры:: source — String, который необходимо проанализировать с начала.
Возвращает:: Date, полученный в результате анализа строки.
Вызывает:: ParseException — если начало указанной строки не удаётся проанализировать.

parse

public abstract Date parse(String source, ParsePosition pos)

Анализирует строку даты и времени в соответствии с указанной позицией анализа. Например, если this имеет шаблон "M/d/yy h:m a, z", текст времени "07/10/96 4:5 PM, PDT" будет преобразован в Date, эквивалентный Date(837039900000L).

По умолчанию анализ выполняется в нестрогом режиме: если входные данные не соответствуют формату, используемому методом format этого объекта, но всё же могут быть проанализированы как дата, анализ завершается успешно. Клиенты могут потребовать строгого соблюдения формата, вызвав метод setLenient(false).

Для получения Date эта операция анализа использует calendar. В результате поля даты и времени объекта calendar и значение TimeZone могут быть перезаписаны в зависимости от реализации подкласса. Значение TimeZone, ранее заданное вызовом setTimeZone, может потребоваться восстановить для дальнейших операций.

Параметры:: source — строка даты и времени для анализа; pos — при входе содержит позицию, с которой следует начать анализ; при выходе — позицию, на которой анализ завершился, или начальную позицию, если анализ не удался.
Возвращает:: Date или null, если входные данные не удалось проанализировать

parseObject

public Object parseObject(String source, ParsePosition pos)

Анализирует текст строки, чтобы получить Date.

Метод пытается анализировать текст, начиная с индекса, заданного в pos. Если анализ завершается успешно, индекс pos обновляется до индекса после последнего использованного символа (для анализа необязательно используются все символы до конца строки), и возвращается проанализированная дата. Обновлённый pos можно использовать как начальную позицию для следующего вызова этого метода. Если возникает ошибка, индекс pos не изменяется, индекс ошибки pos устанавливается равным индексу символа, на котором произошла ошибка, и возвращается null.

Дополнительные сведения об анализе дат см. в методе parse(String, ParsePosition).

Определено в:: parseObject в классе Format
Параметры:: source — String, часть которого необходимо проанализировать.; pos — объект ParsePosition с информацией об индексе и индексе ошибки, описанной выше.
Возвращает:: Date, полученный в результате анализа строки. В случае ошибки возвращает null.
Вызывает:: NullPointerException — если source или pos равен null.

getTimeInstance

public static final DateFormat getTimeInstance()

Возвращает форматировщик времени со стилем форматирования по умолчанию для локали по умолчанию FORMAT.

Эквивалентно вызову getTimeInstance(DEFAULT, Locale.getDefault(Locale.Category.FORMAT)).

Возвращает:

форматировщик времени.

См. также:

getTimeInstance

public static final DateFormat getTimeInstance(int style)

Возвращает форматировщик времени с указанным стилем форматирования для локали по умолчанию FORMAT.

Эквивалентно вызову getTimeInstance(style, Locale.getDefault(Locale.Category.FORMAT)).

Параметры:

style — указанный стиль форматирования. Например, SHORT для «h:mm a» в локали США.

Возвращает:

форматировщик времени.

См. также:

getTimeInstance

public static final DateFormat getTimeInstance(int style, Locale aLocale)

Возвращает форматировщик времени с указанным стилем форматирования для заданной локали.

Параметры:: style — указанный стиль форматирования. Например, SHORT для «h:mm a» в локали США.; aLocale — заданная локаль.
Возвращает:: форматировщик времени.

getDateInstance

public static final DateFormat getDateInstance()

Возвращает форматировщик даты со стилем форматирования по умолчанию для локали по умолчанию FORMAT.

Эквивалентно вызову getDateInstance(DEFAULT, Locale.getDefault(Locale.Category.FORMAT)).

Возвращает:

форматировщик даты.

См. также:

getDateInstance

public static final DateFormat getDateInstance(int style)

Возвращает форматировщик даты с указанным стилем форматирования для локали по умолчанию FORMAT.

Эквивалентно вызову getDateInstance(style, Locale.getDefault(Locale.Category.FORMAT)).

Параметры:

style — указанный стиль форматирования. Например, SHORT для «M/d/yy» в локали США.

Возвращает:

форматировщик даты.

См. также:

getDateInstance

public static final DateFormat getDateInstance(int style, Locale aLocale)

Возвращает форматировщик даты с указанным стилем форматирования для заданной локали.

Параметры:: style — указанный стиль форматирования. Например, SHORT для «M/d/yy» в локали США.; aLocale — заданная локаль.
Возвращает:: форматировщик даты.

getDateTimeInstance

public static final DateFormat getDateTimeInstance()

Возвращает форматировщик даты и времени со стилем форматирования по умолчанию для локали по умолчанию FORMAT.

Эквивалентно вызову getDateTimeInstance(DEFAULT, DEFAULT, Locale.getDefault(Locale.Category.FORMAT)).

Возвращает:

форматировщик даты и времени.

См. также:

getDateTimeInstance

public static final DateFormat getDateTimeInstance(int dateStyle, int timeStyle)

Возвращает форматировщик даты и времени с указанными стилями форматирования даты и времени для локали по умолчанию FORMAT.

Эквивалентно вызову getDateTimeInstance(dateStyle, timeStyle, Locale.getDefault(Locale.Category.FORMAT)).

Параметры:

dateStyle — указанный стиль форматирования даты. Например, SHORT для «M/d/yy» в локали США.

timeStyle — указанный стиль форматирования времени. Например, SHORT для «h:mm a» в локали США.

Возвращает:

форматировщик даты и времени.

См. также:

getDateTimeInstance

public static final DateFormat getDateTimeInstance(int dateStyle, int timeStyle, Locale aLocale)

Возвращает форматировщик даты и времени с указанными стилями форматирования для заданной локали.

Параметры:: dateStyle — указанный стиль форматирования даты.; timeStyle — указанный стиль форматирования времени.; aLocale — заданная локаль.
Возвращает:: форматировщик даты и времени.

getInstance

public static final DateFormat getInstance()

Возвращает форматировщик даты и времени по умолчанию, использующий стиль SHORT как для даты, так и для времени.

Возвращает:: форматировщик даты и времени

getAvailableLocales

public static Locale[] getAvailableLocales()

Возвращает массив всех локалей, для которых методы get*Instance этого класса могут возвращать локализованные экземпляры. Возвращённый массив представляет собой объединение локалей, поддерживаемых средой выполнения Java и установленными реализациями DateFormatProvider. Как минимум, возвращённый массив должен содержать экземпляр Locale, равный Locale.ROOT, и экземпляр Locale, равный Locale.US.

Возвращает:: Массив локалей, для которых доступны локализованные экземпляры DateFormat.

setCalendar

public void setCalendar(Calendar newCalendar)

Задаёт календарь, который будет использоваться этим форматом даты. Изначально используется календарь по умолчанию для указанной или заданной по умолчанию локали.

Все ранее заданные значения TimeZone и нестрогого режима перезаписываются значениями объекта newCalendar.

Параметры:: newCalendar — новый Calendar, который будет использоваться форматом даты

getCalendar

public Calendar getCalendar()

Возвращает календарь, связанный с этим форматировщиком даты и времени.

Возвращает:: календарь, связанный с этим форматировщиком даты и времени.

setNumberFormat

public void setNumberFormat(NumberFormat newNumberFormat)

Позволяет задать форматировщик чисел.

Параметры:: newNumberFormat — новый заданный объект NumberFormat.

getNumberFormat

public NumberFormat getNumberFormat()

Возвращает форматировщик чисел, который этот форматировщик даты и времени использует для форматирования и анализа времени.

Возвращает:: форматировщик чисел, используемый этим форматировщиком даты и времени.

setTimeZone

public void setTimeZone(TimeZone zone)

Устанавливает часовой пояс для календаря этого объекта DateFormat. Этот метод эквивалентен следующему вызову.

getCalendar().setTimeZone(zone);

Значение TimeZone, установленное этим методом, перезаписывается при вызове setCalendar.

Значение TimeZone, установленное этим методом, может быть перезаписано в результате вызова метода parse.

Параметры:: zone — заданный новый часовой пояс.

getTimeZone

public TimeZone getTimeZone()

Возвращает часовой пояс. Этот метод эквивалентен следующему вызову.

getCalendar().getTimeZone();

Возвращает:: часовой пояс, связанный с календарём DateFormat.

setLenient

public void setLenient(boolean lenient)

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

Этот метод эквивалентен следующему вызову.

getCalendar().setLenient(lenient);

Это значение нестрогого режима перезаписывается при вызове setCalendar().

Требования к реализации:

При нестрогом разборе символ SPACE_SEPARATOR во входном тексте соответствует любому другому символу SPACE_SEPARATOR в шаблоне; в противном случае соответствия не будет.

Параметры:

lenient — если true, разбор выполняется в нестрогом режиме

См. также:

isLenient

public boolean isLenient()

Определяет, выполняется ли разбор даты и времени в нестрогом режиме. Этот метод эквивалентен следующему вызову.

getCalendar().isLenient();

Возвращает:

true, если calendar работает в нестрогом режиме; в противном случае — false.

См. также:

hashCode

public int hashCode()

Возвращает хеш-код этого объекта DateFormat.

Переопределяет:

hashCode в классе Object

Требования к реализации:

Этот метод вычисляет значение хеш-кода, используя значение, возвращаемое методом getNumberFormat().

Возвращает:

хеш-код этого объекта DateFormat

См. также:

equals

public boolean equals(Object obj)

Сравнивает указанный объект с этим объектом DateFormat на равенство. Возвращает true, если указанный объект также является объектом DateFormat и оба формата одинаково форматируют любое значение.

Переопределяет:

equals в классе Object

Требования к реализации:

Этот метод проверяет равенство, определяя идентичность класса на основе getClass(), а не instanceof. Поэтому методы equals в подклассах не должны считать экземпляр этого класса равным экземпляру подкласса.

Параметры:

obj — объект для сравнения на равенство

Возвращает:

true, если указанный объект равен этому объекту DateFormat

См. также:

clone

public Object clone()

Переопределяет Cloneable

Переопределяет:

clone в классе Format

Возвращает:

клонированный экземпляр этого объекта.

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.