compact1, compact2, compact3

java.util.spi

Class CalendarNameProvider

java.lang.Object

java.util.spi.LocaleServiceProvider

java.util.spi.CalendarNameProvider

public abstract class CalendarNameProvider
extends LocaleServiceProvider

为服务提供商提供本地化的字符串表示一个抽象类（显示名称）的 Calendar字段值。

Calendar Types

日历类型用于指定日历系统，getDisplayName和getDisplayNames方法提供日历字段值的名称。看到Calendar.getCalendarType()详情。

日历字段

日历字段中定义的常数指定Calendar。以下是为每个日历系统支持的日历通用字段及其值。

Field	Value	描述
Calendar.MONTH	Calendar.JANUARY to Calendar.UNDECIMBER	Month numbering is 0-based (e.g., 0 - January, ..., 11 - December). Some calendar systems have 13 months. Month names need to be supported in both the formatting and stand-alone forms if required by the supported locales. If there's no distinction in the two forms, the same names should be returned in both of the forms.
Calendar.DAY_OF_WEEK	Calendar.SUNDAY to Calendar.SATURDAY	Day-of-week numbering is 1-based starting from Sunday (i.e., 1 - Sunday, ..., 7 - Saturday).
Calendar.AM_PM	Calendar.AM to Calendar.PM	0 - AM, 1 - PM

以下是要支持的日历特定字段和它们的值。

Calendar Type	Field	Value	描述
"gregory"	Calendar.ERA	0	GregorianCalendar.BC (BCE)
		1	GregorianCalendar.AD (CE)
"buddhist"	Calendar.ERA	0	BC (BCE)
		1	B.E. (Buddhist Era)
"japanese"	Calendar.ERA	0	Seireki (Before Meiji)
		1	Meiji
		2	Taisho
		3	Showa
		4	Heisei
	Calendar.YEAR	1	the first year in each era. It should be returned when a long style (Calendar.LONG_FORMAT or Calendar.LONG_STANDALONE) is specified. See also the Year representation in SimpleDateFormat.
"roc"	Calendar.ERA	0	Before R.O.C.
		1	R.O.C.
"islamic"	Calendar.ERA	0	Before AH
		1	Anno Hijrah (AH)

对于"gregory"日历字段值的名称必须与所提供的DateFormatSymbolsProvider日期时间符号一致。

时区的名字都是由TimeZoneNameProvider。

从以下版本开始：

一点八

另请参见：

CalendarDataProvider， Locale.getUnicodeLocaleType(String)

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	CalendarNameProvider() 唯一的构造函数。

方法摘要

Modifier and Type	Method and Description
abstract String	getDisplayName(String calendarType, int field, int value, int style, Locale locale) 返回的字符串表示形式（显示名称）在给定的 style和 locale日历的 field value。
abstract Map<String,Integer>	getDisplayNames(String calendarType, int field, int style, Locale locale) 返回一个包含所有的字符串表示 Map（显示名称）的 Calendar field在给定的 style和 locale及其相应的字段值。

Methods inherited from class java.util.spi.LocaleServiceProvider

getAvailableLocales, isSupportedLocale

Methods inherited from class java.lang.Object

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

Constructor Detail

CalendarNameProvider

protected CalendarNameProvider()

唯一的构造函数。（用于调用子类构造函数，通常是隐式的。）

方法详细信息

getDisplayName

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

返回的字符串表示形式（显示名称）在给定的 style和 locale日历的 field value。如果没有字符串表示形式是适用的， 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（“格雷戈瑞”，calendar.day_of_week，calendar.sunday，calendar.long_standalone，现场英语）；

参数

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无效

如果是 null locale NullPointerException

另请参见：

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及其相应的字段值。

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。请注意，狭窄的名字可能不是唯一的，由于使用单一的字符，如“S”为星期日和星期六，并没有狭窄的名称包括在这种情况下。

例如，下面的调用将返回一个Map含"January"到Calendar.JANUARY，"Jan"到Calendar.JANUARY，"February"到Calendar.FEBRUARY，"Feb"到Calendar.FEBRUARY，等等。

getdisplaynames（“格雷戈瑞”，calendar.month，calendar.all_styles，现场。英语）；

参数

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含在 style和 locale及其 field值 field所有显示的名称，或 null如果没有显示名称被定义为 field

异常

如果是 null locale NullPointerException

另请参见：

Calendar.getDisplayNames(int, int, Locale)