Класс 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);

Если указанный регион содержит «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.

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

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

Также можно использовать формы методов parse и format с 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

См. также:

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

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

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

Modifier and Type	Field	Description
`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()

Modifier	Constructor	Description
`protected`	Создаёт новый формат даты.

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

Modifier and Type	Method	Description
`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`.

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

format, formatToCharacterIterator, parseObject

Методы, объявленные в классе java.lang.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

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

См. также:

YEAR_FIELD

public static final int YEAR_FIELD

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

См. также:

MONTH_FIELD

public static final int MONTH_FIELD

Полезная константа для выравнивания поля МЕСЯЦ. Используется в FieldPosition форматирования даты/времени.

См. также:

DATE_FIELD

public static final int DATE_FIELD

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

См. также:

HOUR_OF_DAY1_FIELD

public static final int HOUR_OF_DAY1_FIELD

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

См. также:

HOUR_OF_DAY0_FIELD

public static final int HOUR_OF_DAY0_FIELD

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

См. также:

MINUTE_FIELD

public static final int MINUTE_FIELD

Полезная константа для выравнивания поля МИНУТА. Используется в FieldPosition форматирования даты/времени.

См. также:

SECOND_FIELD

public static final int SECOND_FIELD

Полезная константа для выравнивания поля СЕКУНДА. Используется в FieldPosition форматирования даты/времени.

См. также:

MILLISECOND_FIELD

public static final int MILLISECOND_FIELD

Полезная константа для выравнивания поля МИЛЛИСЕКУНДА. Используется в FieldPosition форматирования даты/времени.

См. также:

DAY_OF_WEEK_FIELD

public static final int DAY_OF_WEEK_FIELD

Полезная константа для выравнивания поля ДЕНЬ_НЕДЕЛИ. Используется в FieldPosition форматирования даты/времени.

См. также:

DAY_OF_YEAR_FIELD

public static final int DAY_OF_YEAR_FIELD

Полезная константа для выравнивания поля ДЕНЬ_ГОДА. Используется в FieldPosition форматирования даты/времени.

См. также:

DAY_OF_WEEK_IN_MONTH_FIELD

public static final int DAY_OF_WEEK_IN_MONTH_FIELD

Полезная константа для выравнивания поля ДЕНЬ_НЕДЕЛИ_В_МЕСЯЦЕ. Используется в FieldPosition форматирования даты/времени.

См. также:

WEEK_OF_YEAR_FIELD

public static final int WEEK_OF_YEAR_FIELD

Полезная константа для выравнивания поля НЕДЕЛЯ_ГОДА. Используется в FieldPosition форматирования даты/времени.

См. также:

WEEK_OF_MONTH_FIELD

public static final int WEEK_OF_MONTH_FIELD

Полезная константа для выравнивания поля НЕДЕЛЯ_МЕСЯЦА. Используется в FieldPosition форматирования даты/времени.

См. также:

AM_PM_FIELD

public static final int AM_PM_FIELD

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

См. также:

HOUR1_FIELD

public static final int HOUR1_FIELD

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

См. также:

HOUR0_FIELD

public static final int HOUR0_FIELD

Полезная константа для выравнивания поля HOUR с основанием 0. Используется в FieldPosition форматирования даты/времени. HOUR0_FIELD используется для 12-часовых часов с основанием 0. Например, 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

Константа для шаблона стиля medium.

См. также:

SHORT

public static final int SHORT

Константа для шаблона стиля 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).

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

Этот операция разбора использует calendar для создания Date. В результате, поля даты и времени 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()

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

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

Возвращает:

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

См. также:

getTimeInstance

public static final DateFormat getTimeInstance(int style)

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

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

Параметры:

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

Возвращает:

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

См. также:

getTimeInstance

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

Получает форматтер времени с заданным стилем форматирования для заданного региона.

Parameters:: style - заданный стиль форматирования. Например, SHORT для "ч:мм а" в американском регионе.; aLocale - заданный регион.
Returns:: форматтер времени.

getDateInstance

public static final DateFormat getDateInstance()

Получает форматтер даты с установленным по умолчанию стилем форматирования для региона по умолчанию FORMAT.

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

Returns:

форматтер даты.

See Also:

getDateInstance

public static final DateFormat getDateInstance(int style)

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

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

Parameters:

style - заданный стиль форматирования. Например, SHORT для "Д/М/ГГ" в американском регионе.

Returns:

форматтер даты.

See Also:

getDateInstance

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

Получает форматтер даты с заданным стилем форматирования для заданного региона.

Parameters:: style - заданный стиль форматирования. Например, SHORT для "Д/М/ГГ" в американском регионе.; aLocale - заданный регион.
Returns:: форматтер даты.

getDateTimeInstance

public static final DateFormat getDateTimeInstance()

Получает форматтер даты и времени с установленным по умолчанию стилем форматирования для региона по умолчанию FORMAT.

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

Returns:

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

See Also:

getDateTimeInstance

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

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

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

Parameters:

dateStyle - заданный стиль форматирования даты. Например, SHORT для "Д/М/ГГ" в американском регионе.

timeStyle - заданный стиль форматирования времени. Например, SHORT для "ч:мм а" в американском регионе.

Returns:

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

See Also:

getDateTimeInstance

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

Получает форматтер даты и времени с заданными стилями форматирования для заданного региона.

Parameters:: dateStyle - заданный стиль форматирования даты.; timeStyle - заданный стиль форматирования времени.; aLocale - заданный регион.
Returns:: форматтер даты и времени.

getInstance

public static final DateFormat getInstance()

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

Returns:: форматтер даты и времени

getAvailableLocales

public static Locale[] getAvailableLocales()

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

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

setCalendar

public void setCalendar(Calendar newCalendar)

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

Любые значения TimeZone и строгость, которые были установлены ранее, перезаписываются значениями newCalendar.

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

getCalendar

public Calendar getCalendar()

Получает связанный с этим форматом даты/времени календарь.

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

setNumberFormat

public void setNumberFormat(NumberFormat newNumberFormat)

Позволяет установить формат числа.

Parameters:: newNumberFormat - заданный новый NumberFormat.

getNumberFormat

public NumberFormat getNumberFormat()

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

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

setTimeZone

public void setTimeZone(TimeZone zone)

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

getCalendar().setTimeZone(zone);

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

Часовой пояс, установленный этим методом, может быть перезаписан в результате вызова метода разбора.

Parameters:: zone - заданный новый часовой пояс.

getTimeZone

public TimeZone getTimeZone()

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

getCalendar().getTimeZone();

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

setLenient

public void setLenient(boolean lenient)

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

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

getCalendar().setLenient(lenient);

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

Implementation Requirements:

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

Parameters:

lenient - если true, разбор гибкий

See Also:

isLenient

public boolean isLenient()

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

getCalendar().isLenient();

Returns:

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

See Also:

hashCode

public int hashCode()

Возвращает код хэш-суммы для данного DateFormat.

Overrides:

hashCode в классе Object

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

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

Возвращает:

код хэш-суммы для данного DateFormat

См. также:

equals

public boolean equals(Object obj)

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

Overrides:

equals в классе Object

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

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

Параметры:

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

Возвращает:

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

См. также:

clone

public Object clone()

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

Overrides:

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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/text/DateFormat.html