compact1, compact2, compact3

java.util.spi

Класс CalendarNameProvider

java.lang. Объект

java.util.spi. LocaleServiceProvider

java.util.spi. CalendarNameProvider

public abstract class CalendarNameProvider
extends LocaleServiceProvider

Абстрактный class для поставщиков услуг, которые обеспечивают локализованные строковые представления (имена дисплея) 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 (BCE)
		1	GregorianCalendar.AD (CE)
"buddhist"	Calendar.ERA	0	BC (BCE)
		1	B.E. (Буддистская Эра)
"japanese"	Calendar.ERA	0	Seireki (Перед Мэйдзи)
		1	Мэйдзи
		2	Тайсё
		3	Showa
		4	Heisei
	Calendar.YEAR	1	первый год в каждую эру. Это должно быть возвращено когда длинный стиль (Calendar.LONG_FORMAT или Calendar.LONG_STANDALONE) определяется. См. также представление Года в SimpleDateFormat.
"roc"	Calendar.ERA	0	Перед R.O.C.
		1	R.O.C.
"islamic"	Calendar.ERA	0	Перед AH
		1	Anno Hijrah (AH)

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

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

С тех пор:

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) Возвраты a Map содержа все строковые представления (выводят на экран имена) Calendar field в данном style и locale и их соответствующие значения полей.

Методы, наследованные от class java.util.spi. LocaleServiceProvider

getAvailableLocales, isSupportedLocale

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

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 a 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)

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

field a 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. Отметьте, что узкие имена, возможно, не уникальны из-за использования единственных символов, таких как "S" в течение воскресенья и в субботу, и что никакие узкие имена не включаются в этом случае.

Например, следующий вызов возвратит a 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 - требуемая локаль

Возвраты:

a Map содержа все имена дисплея field в style и locale и их field значения, или null если никакие имена дисплея не определяются для field

Броски:

NullPointerException - если locale null

См. Также:

Calendar.getDisplayNames(int, int, Locale)