Класс 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 - январь, ..., 11 - декабрь). Некоторые системы календарей имеют 13 месяцев. Имена месяцев должны поддерживаться как в формате форматирования, так и в формате самостоятельного представления, если это требуется поддерживаемыми локалями. Если различий между двумя формами нет, то должны возвращаться одинаковые имена в обеих формах.
`Calendar.DAY_OF_WEEK`	`Calendar.SUNDAY` до `Calendar.SATURDAY`	Нумерация дней недели основана на единице, начиная с воскресенья (т. е. 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	Хэйсэй
	`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	Anno Hijrah (AH)

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

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

Since:: 1.8
См. также:: CalendarDataProvider, Locale.getUnicodeLocaleType(String)

Конструкторы

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

Методы

Модификатор и тип	Метод и описание
`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, такой как 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
См. также:: TimeZoneNameProvider, Calendar.get(int), Calendar.getDisplayName(int, int, Locale)

getDisplayNames

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

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

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

Например, следующий вызов вернёт 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 и соответствующие значения field, или null, если для field определены никакие названия для отображения
Исключения:: NullPointerException — если locale имеет значение null
См. также:: Calendar.getDisplayNames(int, int, Locale)

© 1993, 2020, 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.