Класс DateFormatter

javax.swing.text.DateFormatter

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

public class DateFormatter extends InternationalFormatter

DateFormatter — это InternationalFormatter, выполняющий форматирование с помощью экземпляра java.text.DateFormat.

Предупреждение: сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, в пакет java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:

1.4

См. также:

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

Конструктор	Описание
`DateFormatter()`	Это сокращённая форма записи для `new DateFormatter(DateFormat.getDateInstance())`.
`DateFormatter(DateFormat format)`	Возвращает DateFormatter, настроенный с указанным экземпляром `Format`.

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

Модификатор и тип	Метод	Описание
`void`	`setFormat(DateFormat format)`	Задаёт формат, определяющий допустимые значения, которые можно редактировать и отображать.

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

clone, getActions, getFields, getFormat, getMaximum, getMinimum, install, setFormat, setMaximum, setMinimum, stringToValue, valueToString

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создаёт копию DefaultFormatter.
`protected Action[]`	`getActions()`	Если `getSupportsIncrement` возвращает true, возвращаются два действия для увеличения или уменьшения значения.
`Format.Field[]`	`getFields(int offset)`	Возвращает константы `Format.Field`, связанные с текстом в `offset`.
`Format`	`getFormat()`	Возвращает формат, определяющий допустимые значения, которые можно редактировать и отображать.
`Comparable<?>`	`getMaximum()`	Возвращает максимально допустимое значение.
`Comparable<?>`	`getMinimum()`	Возвращает минимально допустимое значение.
`void`	`install(JFormattedTextField ftf)`	Устанавливает `DefaultFormatter` для определённого `JFormattedTextField`.
`void`	`setFormat(Format format)`	Задаёт формат, определяющий допустимые значения, которые можно редактировать и отображать.
`void`	`setMaximum(Comparable<?> max)`	Задаёт максимально допустимое значение.
`void`	`setMinimum(Comparable<?> minimum)`	Задаёт минимально допустимое значение.
`Object`	`stringToValue(String text)`	Возвращает представление `Object` для `String` `text`.
`String`	`valueToString(Object value)`	Возвращает строковое представление объекта `value`.

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

getAllowsInvalid, getCommitsOnValidEdit, getDocumentFilter, getNavigationFilter, getOverwriteMode, getValueClass, setAllowsInvalid, setCommitsOnValidEdit, setOverwriteMode, setValueClass

Модификатор и тип	Метод	Описание
`boolean`	`getAllowsInvalid()`	Возвращает, разрешено ли редактируемому значению оставаться недопустимым в течение некоторого времени.
`boolean`	`getCommitsOnValidEdit()`	Возвращает момент публикации изменений в `JFormattedTextField`.
`protected DocumentFilter`	`getDocumentFilter()`	Возвращает `DocumentFilter`, используемый для ограничения символов, которые можно вводить в `JFormattedTextField`.
`protected NavigationFilter`	`getNavigationFilter()`	Возвращает `NavigationFilter`, используемый для ограничения мест, в которых можно разместить курсор.
`boolean`	`getOverwriteMode()`	Возвращает поведение при вставке символов.
`Class<?>`	`getValueClass()`	Возвращает класс, используемый для создания новых объектов.
`void`	`setAllowsInvalid(boolean allowsInvalid)`	Задаёт, разрешено ли редактируемому значению оставаться недопустимым в течение некоторого времени (то есть `stringToValue` выбрасывает `ParseException`).
`void`	`setCommitsOnValidEdit(boolean commit)`	Задаёт момент публикации изменений в `JFormattedTextField`.
`void`	`setOverwriteMode(boolean overwriteMode)`	Настраивает поведение при вставке символов.
`void`	`setValueClass(Class<?> valueClass)`	Задаёт класс, используемый для создания новых объектов.

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

getFormattedTextField, invalidEdit, setEditValid, uninstall

Модификатор и тип	Метод	Описание
`protected JFormattedTextField`	`getFormattedTextField()`	Возвращает текущий `JFormattedTextField`, для которого установлен `AbstractFormatter`.
`protected void`	`invalidEdit()`	Этот метод следует вызывать, когда пользователь вводит недопустимый символ.
`protected void`	`setEditValid(boolean valid)`	Вызовите этот метод, чтобы обновить свойство `editValid` объекта `JFormattedTextField`.
`void`	`uninstall()`	Удаляет любое состояние, которое `AbstractFormatter` мог установить в `JFormattedTextField`.

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

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

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

DateFormatter

public DateFormatter()

Это сокращённая форма записи для new DateFormatter(DateFormat.getDateInstance()).

DateFormatter

public DateFormatter(DateFormat format)

Возвращает DateFormatter, настроенный с указанным экземпляром Format.

Параметры:: format — формат, используемый для определения допустимых значений

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

setFormat

public void setFormat(DateFormat format)

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

Если вы использовали конструктор без аргументов, значение этого свойства будет определено для текущей локали с помощью метода Dateformat.getDateInstance().

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

© 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.