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 Description 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 Description "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支持 。

从以下版本开始：

1.8

另请参见：

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

构造方法详细信息

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

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("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)