Класс CalendarNameProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.util.spi.CalendarNameProvider

public abstract class CalendarNameProvider extends LocaleServiceProvider

Абстрактный класс для поставщиков сервисов, которые предоставляют локализованные строковые представления (отображаемые имена) значений полей Calendar.

Типы календарей

Типы календарей используются для указания систем календарей, для которых методы getDisplayName и getDisplayNames предоставляют имена значений полей календаря. Подробнее см. Calendar.getCalendarType().

Поля календаря

Поля календаря задаются константами, определёнными в Calendar. Ниже приведены общие поля календаря и их значения, которые необходимо поддерживать для каждой системы календарей.

Значения полей
Поле	Значение	Описание
`Calendar.MONTH`	`Calendar.JANUARY` до `Calendar.UNDECIMBER`	Нумерация месяцев основана на 0 (например, 0 — январь, ..., 11 — декабрь). В некоторых системах календарей 13 месяцев. Имена месяцев необходимо поддерживать как в формате форматирования, так и в формате автономного использования, если это требуется поддерживаемыми локалями. Если различия между двумя формами отсутствуют, то одни и те же имена должны возвращаться в обоих форматах.
`Calendar.DAY_OF_WEEK`	`Calendar.SUNDAY` до `Calendar.SATURDAY`	Нумерация дней недели основана на 1, начиная с воскресенья (т. е., 1 — воскресенье, ..., 7 — суббота).
`Calendar.AM_PM`	`Calendar.AM` до `Calendar.PM`	0 — AM, 1 — PM

Ниже приведены специфичные для календаря поля и их значения, которые необходимо поддерживать.

Типы календаря и значения полей
Тип календаря	Поле	Значение	Описание
`"gregory"`	`Calendar.ERA`	0	`GregorianCalendar.BC` (до н. э.)
`"gregory"`	`Calendar.ERA`	1	`GregorianCalendar.AD` (н. э.)
`"buddhist"`	`Calendar.ERA`	0	до н. э. (до нашей эры)
`"buddhist"`	`Calendar.ERA`	1	Б.Э. (буддийская эра)
`"japanese"`	`Calendar.ERA`	0	Сэйрэйки (до Мэйдзи)
		1	Мэйдзи
		2	Тайсё
		3	Сёва
		4	Хэйсэй
		5	Рэйва
	`Calendar.YEAR`	1	первый год в каждой эре. Он должен возвращаться при указании длинного стиля (`Calendar.LONG_FORMAT` или `Calendar.LONG_STANDALONE`). Также см. представление года в `SimpleDateFormat`.
`"roc"`	`Calendar.ERA`	0	До Р.О.Ц.
`"roc"`	`Calendar.ERA`	1	Р.О.Ц.
`"islamic"`	`Calendar.ERA`	0	До AH
`"islamic"`	`Calendar.ERA`	1	Хиджра (AH)

Имена значений полей календаря для "gregory" должны соответствовать символам даты и времени, предоставляемым DateFormatSymbolsProvider.

Имена часовых поясов поддерживаются классом TimeZoneNameProvider.

Since:

1.8

См. также:

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

CalendarNameProvider()

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

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

Модификатор и тип	Метод	Описание
`abstract String`	`getDisplayName(String calendarType, int field, int value, int style, Locale locale)`	Возвращает строковое представление (отображаемое имя) календаря `field value` в заданной `style` и `locale`.
`abstract Map<String,Integer>`	`getDisplayNames(String calendarType, int field, int style, Locale locale)`	Возвращает `Map`, содержащий все строковые представления (отображаемые имена) полей `Calendar` `field` в заданной `style` и `locale` и их соответствующие значения.

Методы, объявленные в классе java.util.spi.LocaleServiceProvider

getAvailableLocales, isSupportedLocale

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

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

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

CalendarNameProvider

protected CalendarNameProvider()

Единственный конструктор. (Для вызова конструкторами подклассов, обычно неявный.)

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

getDisplayName

public abstract String getDisplayName(String calendarType, int field, int value, int style, Locale locale)

Возвращает строковое представление (отображаемое имя) календаря field value в заданном style и locale. Если строковое представление не применимо, возвращается null.

field — это индекс поля календаря, например, Calendar.MONTH. Поля временной зоны, Calendar.ZONE_OFFSET и Calendar.DST_OFFSET, не поддерживаются этим методом. При указании любых полей временной зоны должен возвращаться null.

value — это числовое представление значения field. Например, если field — это Calendar.DAY_OF_WEEK, допустимые значения — от Calendar.SUNDAY до Calendar.SATURDAY (включительно).

style задаёт стиль строкового представления. Он должен быть одним из: Calendar.SHORT_FORMAT (SHORT), Calendar.SHORT_STANDALONE, Calendar.LONG_FORMAT (LONG), Calendar.LONG_STANDALONE, Calendar.NARROW_FORMAT или Calendar.NARROW_STANDALONE.

Например, следующий вызов вернёт "Sunday".

 getDisplayName("gregory", Calendar.DAY_OF_WEEK, Calendar.SUNDAY,
                Calendar.LONG_STANDALONE, Locale.ENGLISH);

Параметры:

calendarType - тип календаря. (Любой тип календаря, заданный locale, игнорируется.)

field - индекс поля Calendar, например, Calendar.DAY_OF_WEEK

value - значение Calendar field, например, Calendar.MONDAY

style - стиль строкового представления: один из Calendar.SHORT_FORMAT (SHORT), Calendar.SHORT_STANDALONE, Calendar.LONG_FORMAT (LONG), Calendar.LONG_STANDALONE, Calendar.NARROW_FORMAT или Calendar.NARROW_STANDALONE

locale - желаемая локаль

Возвращает:

строковое представление field value или


         null

, если строковое представление неприменимо или заданный тип календаря неизвестен

Исключения:

IllegalArgumentException - если field или style некорректны

NullPointerException - если locale — null

См. также:

getDisplayNames

public abstract Map<String,Integer> getDisplayNames(String calendarType, int field, int style, Locale locale)

Возвращает Map, содержащий все строковые представления (отображаемые имена) Calendar field в заданной style и locale, а также соответствующие значения полей.

field — это индекс поля Calendar, например, Calendar.MONTH. Поля временной зоны, Calendar.ZONE_OFFSET и Calendar.DST_OFFSET, не поддерживаются этим методом. При указании любых полей временной зоны возвращается null.

style задаёт стиль строкового представления. Он должен быть одним из Calendar.ALL_STYLES, Calendar.SHORT_FORMAT (SHORT), Calendar.SHORT_STANDALONE, Calendar.LONG_FORMAT (LONG), Calendar.LONG_STANDALONE, Calendar.NARROW_FORMAT или Calendar.NARROW_STANDALONE. Обратите внимание, что узкие имена могут не быть уникальными из-за использования одиночных символов, таких как "В" для воскресенья и субботы, и в этом случае узкие имена не включаются.

Например, следующий вызов вернёт Map, содержащий "January" до Calendar.JANUARY, "Jan" до Calendar.JANUARY, "February" до Calendar.FEBRUARY, "Feb" до Calendar.FEBRUARY и так далее.

 getDisplayNames("gregory", Calendar.MONTH, Calendar.ALL_STYLES, Locale.ENGLISH);

Параметры:

calendarType - тип календаря. (Любой тип календаря, заданный locale, игнорируется.)

field - поле календаря, для которого возвращаются отображаемые имена

style - стиль, применяемый к отображаемым именам; один из Calendar.ALL_STYLES, Calendar.SHORT_FORMAT (SHORT), Calendar.SHORT_STANDALONE, Calendar.LONG_FORMAT (LONG), Calendar.LONG_STANDALONE, Calendar.NARROW_FORMAT или Calendar.NARROW_STANDALONE

locale - желаемая локаль

Возвращает:

Map, содержащий все отображаемые имена field в style и locale и их соответствующие значения, или null, если отображаемые имена не определены для field

Исключения:

NullPointerException - если locale — null

См. также:

© 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/util/spi/CalendarNameProvider.html