Класс 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 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()`	Возвращает форматировщик даты и времени по умолчанию, использующий короткий стиль для даты и времени.
`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

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

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

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

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 — дата, которую нужно отформатировать в строку даты и времени.; 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).

По умолчанию разбор выполняется в нестрогом режиме: если входные данные не соответствуют формату, используемому методом форматирования этого объекта, но все же могут быть разобраны как дата, разбор завершается успешно. Клиенты могут потребовать строгого соответствия формату, вызвав 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/text/DateFormat.html