Класс DateFormat.Field

java.text.DateFormat.Field

Все реализуемые интерфейсы:: Serializable

Внешний класс:: DateFormat

public static class DateFormat.Field extends Format.Field

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

Класс также предоставляет два метода для сопоставления своих констант с соответствующими константами Calendar.

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

1.4

См. также:

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

Модификатор и тип	Поле	Описание
`static final DateFormat.Field`	`AM_PM`	Константа, обозначающая поле указателя времени суток (например, «до полудня» или «после полудня»).
`static final DateFormat.Field`	`DAY_OF_MONTH`	Константа, обозначающая поле дня месяца.
`static final DateFormat.Field`	`DAY_OF_WEEK`	Константа, обозначающая поле дня недели.
`static final DateFormat.Field`	`DAY_OF_WEEK_IN_MONTH`	Константа, обозначающая поле дня недели.
`static final DateFormat.Field`	`DAY_OF_YEAR`	Константа, обозначающая поле дня года.
`static final DateFormat.Field`	`ERA`	Константа, обозначающая поле эры.
`static final DateFormat.Field`	`HOUR_OF_DAY0`	Константа, обозначающая поле часа суток, допустимые значения которого находятся в диапазоне от 0 до 23.
`static final DateFormat.Field`	`HOUR_OF_DAY1`	Константа, обозначающая поле часа суток, допустимые значения которого находятся в диапазоне от 1 до 24.
`static final DateFormat.Field`	`HOUR0`	Константа, обозначающая поле часа, допустимые значения которого находятся в диапазоне от 0 до 11.
`static final DateFormat.Field`	`HOUR1`	Константа, обозначающая поле часа, допустимые значения которого находятся в диапазоне от 1 до 12.
`static final DateFormat.Field`	`MILLISECOND`	Константа, обозначающая поле миллисекунд.
`static final DateFormat.Field`	`MINUTE`	Константа, обозначающая поле минут.
`static final DateFormat.Field`	`MONTH`	Константа, обозначающая поле месяца.
`static final DateFormat.Field`	`SECOND`	Константа, обозначающая поле секунд.
`static final DateFormat.Field`	`TIME_ZONE`	Константа, обозначающая поле часового пояса.
`static final DateFormat.Field`	`WEEK_OF_MONTH`	Константа, обозначающая поле недели месяца.
`static final DateFormat.Field`	`WEEK_OF_YEAR`	Константа, обозначающая поле недели года.
`static final DateFormat.Field`	`YEAR`	Константа, обозначающая поле года.

Поля, объявленные в классе AttributedCharacterIterator.Attribute

INPUT_METHOD_SEGMENT, LANGUAGE, READING

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

Field(String name,
 int calendarField)

Модификатор	Конструктор	Описание
`protected`	Создает `Field`.

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

Модификатор и тип	Метод	Описание
`int`	`getCalendarField()`	Возвращает поле `Calendar`, связанное с этим атрибутом.
`static DateFormat.Field`	`ofCalendarField(int calendarField)`	Возвращает константу `Field`, соответствующую константе `Calendar` `calendarField`.
`protected Object`	`readResolve()`	Преобразует десериализуемые экземпляры в предопределенные константы.

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

equals, getName, hashCode, toString

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

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

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

ERA

public static final DateFormat.Field ERA

Константа, обозначающая поле эры.

YEAR

public static final DateFormat.Field YEAR

Константа, обозначающая поле года.

MONTH

public static final DateFormat.Field MONTH

Константа, обозначающая поле месяца.

DAY_OF_MONTH

public static final DateFormat.Field DAY_OF_MONTH

Константа, обозначающая поле дня месяца.

HOUR_OF_DAY1

public static final DateFormat.Field HOUR_OF_DAY1

Константа, обозначающая поле часа суток, допустимые значения которого находятся в диапазоне от 1 до 24.

HOUR_OF_DAY0

public static final DateFormat.Field HOUR_OF_DAY0

Константа, обозначающая поле часа суток, допустимые значения которого находятся в диапазоне от 0 до 23.

MINUTE

public static final DateFormat.Field MINUTE

Константа, обозначающая поле минут.

SECOND

public static final DateFormat.Field SECOND

Константа, обозначающая поле секунд.

MILLISECOND

public static final DateFormat.Field MILLISECOND

Константа, обозначающая поле миллисекунд.

DAY_OF_WEEK

public static final DateFormat.Field DAY_OF_WEEK

Константа, обозначающая поле дня недели.

DAY_OF_YEAR

public static final DateFormat.Field DAY_OF_YEAR

Константа, обозначающая поле дня года.

DAY_OF_WEEK_IN_MONTH

public static final DateFormat.Field DAY_OF_WEEK_IN_MONTH

Константа, обозначающая поле дня недели.

WEEK_OF_YEAR

public static final DateFormat.Field WEEK_OF_YEAR

Константа, обозначающая поле недели года.

WEEK_OF_MONTH

public static final DateFormat.Field WEEK_OF_MONTH

Константа, обозначающая поле недели месяца.

AM_PM

public static final DateFormat.Field AM_PM

Константа, обозначающая поле указателя времени суток (например, «до полудня» или «после полудня»).

HOUR1

public static final DateFormat.Field HOUR1

Константа, обозначающая поле часа, допустимые значения которого находятся в диапазоне от 1 до 12.

HOUR0

public static final DateFormat.Field HOUR0

Константа, обозначающая поле часа, допустимые значения которого находятся в диапазоне от 0 до 11.

TIME_ZONE

public static final DateFormat.Field TIME_ZONE

Константа, обозначающая поле часового пояса.

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

Поле

protected Field(String name, int calendarField)

Создает Field.

Параметры:: name — имя Field; calendarField — константа Calendar, которой соответствует этот Field; можно использовать любое значение, даже не входящее в диапазон допустимых значений Calendar, но для значений, не соответствующих допустимым значениям Calendar, следует использовать -1

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

ofCalendarField

public static DateFormat.Field ofCalendarField(int calendarField)

Возвращает константу Field, соответствующую константе Calendar calendarField. Если прямого соответствия между константой Calendar и Field нет, возвращается null.

Параметры:

calendarField — константа поля Calendar

Возвращает:

Экземпляр Field, представляющий calendarField.

Вызывает исключение:

IllegalArgumentException — если calendarField не является значением константы поля Calendar.

См. также:

getCalendarField

public int getCalendarField()

Возвращает поле Calendar, связанное с этим атрибутом. Например, если этот атрибут представляет поле часов в Calendar, данный метод вернет Calendar.HOUR. Возвращаемое значение -1 гарантирует, что это поле не представляет соответствующую константу в Calendar.

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

Реализация по умолчанию всегда возвращает -1, если оно не представляет соответствующую константу в Calendar.

Возвращает:

Константа Calendar для этого поля

См. также:

readResolve

protected Object readResolve() throws InvalidObjectException

Преобразует десериализуемые экземпляры в предопределенные константы.

Переопределяет:: readResolve в классе AttributedCharacterIterator.Attribute
Возвращает:: разрешенная константа DateFormat.Field
Вызывает исключение:: InvalidObjectException — если не удалось разрешить константу.

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