Most visited

Recently visited

Results for

Added in API level 24
Summary: Constants | Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

DateFormatSymbols

public class DateFormatSymbols
extends Object implements Serializable, Cloneable

java.lang.Object
   ↳ android.icu.text.DateFormatSymbols

[icu增强] ICU的替代DateFormatSymbols 。 ICU特有的方法，字段和其他功能标记为“ [icu] ”。

DateFormatSymbols是封装可本地化的日期时间格式数据的公共类，例如月份名称，一周中的日期名称和时区数据。 DateFormat和SimpleDateFormat都使用DateFormatSymbols来封装这些信息。

通常你不应该直接使用DateFormatSymbols 。 相反，我们鼓励你创建一个日期-时间格式化DateFormat类的工厂方法： getTimeInstance ， getDateInstance ，或getDateTimeInstance 。 这些方法自动为格式化程序创建一个DateFormatSymbols ，以便您不必这样做。 格式化程序创建后，您可以使用setPattern方法修改其格式模式。 有关使用DateFormat的工厂方法创建格式化程序的更多信息，请参阅DateFormat 。

如果您决定为特定区域创建具有特定格式模式的日期 - 时间格式化程序，则可以这样做：

 new SimpleDateFormat(aPattern, new DateFormatSymbols(aLocale)).

DateFormatSymbols对象是可克隆的。 当您获得DateFormatSymbols对象时，请随时修改日期时间格式数据。 例如，您可以将本地化的日期时间格式模式字符替换为您感觉易于记忆的字符。 或者，您可以将代表性城市更改为您最喜欢的城市。

可以添加新的 DateFormatSymbols子类，以支持 SimpleDateFormat用于其他语言环境的日期时间格式设置。

也可以看看：

Summary

Constants
int ABBREVIATED

[icu]宽度不变。
int FORMAT

[icu]用于上下文的常量。
int NARROW

[icu]宽度不变。
int SHORT

[icu]宽度常数; 只支持平日。
int STANDALONE

[icu]用于上下文的常量。
int WIDE

[icu]宽度不变。

Public constructors
DateFormatSymbols()

通过从默认的 FORMAT语言环境的资源加载格式数据构造DateFormatSymbols对象。
DateFormatSymbols(Locale locale)

通过从给定语言环境的资源加载格式数据构造DateFormatSymbols对象。
DateFormatSymbols(ULocale locale)

[icu]通过从给定ulocale的资源加载格式数据构造一个DateFormatSymbols对象。
DateFormatSymbols(Calendar cal, Locale locale)

返回应该用于格式化给定语言环境中日历系统日期的 DateFormatSymbols对象。
DateFormatSymbols(Calendar cal, ULocale locale)

返回应该用于格式化给定语言环境中日历系统的日期的 DateFormatSymbols对象。
DateFormatSymbols(Class<? extends Calendar> calendarClass, Locale locale)

使用Calendar类而不是Calendar实例的DateFormatSymbols（日历，区域设置）的变体。
DateFormatSymbols(Class<? extends Calendar> calendarClass, ULocale locale)

使用Calendar类而不是Calendar实例的DateFormatSymbols（Calendar，ULocale）的变体。
DateFormatSymbols(ResourceBundle bundle, Locale locale)

从给定的资源包中提取自定义日历的DateFormatSymbols。
DateFormatSymbols(ResourceBundle bundle, ULocale locale)

从给定的资源包中提取自定义日历的DateFormatSymbols。

Public methods
Object clone()

覆盖克隆。
boolean equals(Object obj)

覆盖等于。
String[] getAmPmStrings()

返回am / pm字符串。
static Locale[] getAvailableLocales()

返回 getInstance方法可返回本地化实例的所有语言环境的数组。
String[] getEraNames()

[icu]返回时代名称字符串。
String[] getEras()

返回时代字符串。
static DateFormatSymbols getInstance()

返回默认语言环境的DateFormatSymbols实例。
static DateFormatSymbols getInstance(Locale locale)

返回给定语言环境的DateFormatSymbols实例。
static DateFormatSymbols getInstance(ULocale locale)

[icu]返回给定语言环境的DateFormatSymbols实例。
String getLocalPatternChars()

返回本地化的日期时间模式字符。
String[] getMonths(int context, int width)

返回月份字符串。
String[] getMonths()

返回月份字符串。
String[] getQuarters(int context, int width)

[icu]返回季度字符串。
String[] getShortMonths()

返回短月份字符串。
String[] getShortWeekdays()

返回缩写星期字符串; 例如：“太阳”，“星期一”等。
String[] getWeekdays(int context, int width)

返回星期几字符串。
String[] getWeekdays()

返回广泛的星期几字符串。
String[] getYearNames(int context, int width)

如果日历中包含它们，则返回循环年份名称字符串，例如：“嘉子”，“一周”等。
String[] getZodiacNames(int context, int width)

如果日历中包含日历，则返回日历生肖名称字符串，例如：“Rat”，“Ox”，“Tiger”等。
String[][] getZoneStrings()

返回时区字符串。
int hashCode()

覆盖hashCode。
void setAmPmStrings(String[] newAmpms)

设置am / pm字符串。
void setEraNames(String[] newEraNames)

[icu]设置时代名称字符串。
void setEras(String[] newEras)

设置时代字符串。
void setLocalPatternChars(String newLocalPatternChars)

设置本地化的日期时间模式字符。
void setMonths(String[] newMonths)

设置月份字符串。
void setMonths(String[] newMonths, int context, int width)

设置月份字符串。
void setQuarters(String[] newQuarters, int context, int width)

[icu]设置季度字符串。
void setShortMonths(String[] newShortMonths)

设置短月份字符串。
void setShortWeekdays(String[] newAbbrevWeekdays)

设置缩短的星期几字符串; 例如：“太阳”，“星期一”等。
void setWeekdays(String[] newWeekdays)

设置广泛的星期几字符串。
void setWeekdays(String[] newWeekdays, int context, int width)

设置星期几字符串。
void setYearNames(String[] yearNames, int context, int width)

设置循环年份名称字符串，例如：“嘉子”，“一周”等。
void setZodiacNames(String[] zodiacNames, int context, int width)

设置日历生肖名称字符串，例如：“鼠”，“牛”，“虎”等。
void setZoneStrings(String[][] newZoneStrings)

设置时区字符串。

Protected methods
void initializeData(ULocale desiredLocale, String type)

初始化区域设置和日历类型的格式符号

Inherited methods
From class java.lang.Object

Constants

ABBREVIATED

Added in API level 24 
int ABBREVIATED

[icu]宽度不变。

常量值：0（0x00000000）

FORMAT

Added in API level 24 
int FORMAT

[icu]用于上下文的常量。

常量值：0（0x00000000）

NARROW

Added in API level 24 
int NARROW

[icu]宽度不变。

常量值：2（0x00000002）

SHORT

Added in API level 24 
int SHORT

[icu]宽度常数; 只支持平日。

常量值：3（0x00000003）

STANDALONE

Added in API level 24 
int STANDALONE

[icu]用于上下文的常量。

常数值：1（0x00000001）

WIDE

Added in API level 24 
int WIDE

[icu]宽度不变。

常数值：1（0x00000001）

Public constructors

DateFormatSymbols

Added in API level 24 
DateFormatSymbols ()

通过从默认的 FORMAT语言环境的资源加载格式数据构造DateFormatSymbols对象。

Throws
MissingResourceException if the resources for the default locale cannot be found or cannot be loaded.

也可以看看：

DateFormatSymbols

Added in API level 24 
DateFormatSymbols (Locale locale)

通过从给定语言环境的资源加载格式数据构造DateFormatSymbols对象。

Parameters
locale Locale
Throws
MissingResourceException if the resources for the specified locale cannot be found or cannot be loaded.

DateFormatSymbols

Added in API level 24 
DateFormatSymbols (ULocale locale)

[icu]通过从给定ulocale的资源加载格式数据构造一个DateFormatSymbols对象。

Parameters
locale ULocale
Throws
MissingResourceException if the resources for the specified locale cannot be found or cannot be loaded.

DateFormatSymbols

Added in API level 24 
DateFormatSymbols (Calendar cal, 
                Locale locale)

返回应该用于格式化给定语言环境中日历系统的日期的 DateFormatSymbols对象。

子类：
当创建一个新的日历的子类，你必须创建ResourceBundle包含其DateFormatSymbols在一个特定的地方。 资源包名称基于日历的完全指定的类名称，并在包名称末尾（类名前面）插入“.resources”，并在末尾附加“符号”。 例如，对应于“android.icu.util.HebrewCalendar”的包是“android.icu.impl.data.HebrewCalendarSymbols”。

在ResourceBundle中，该方法搜索五个密钥：

  • DayNames - An array of strings corresponding to each possible value of the DAY_OF_WEEK field. Even though DAY_OF_WEEK starts with SUNDAY = 1, This array is 0-based; the name for Sunday goes in the first position, at index 0. If this key is not found in the bundle, the day names are inherited from the default DateFormatSymbols for the requested locale.
  • DayAbbreviations - An array of abbreviated day names corresponding to the values in the "DayNames" array. If this key is not found in the resource bundle, the "DayNames" values are used instead. If neither key is found, the day abbreviations are inherited from the default DateFormatSymbols for the locale.
  • MonthNames - An array of strings corresponding to each possible value of the MONTH field. If this key is not found in the bundle, the month names are inherited from the default DateFormatSymbols for the requested locale.
  • MonthAbbreviations - An array of abbreviated day names corresponding to the values in the "MonthNames" array. If this key is not found in the resource bundle, the "MonthNames" values are used instead. If neither key is found, the day abbreviations are inherited from the default DateFormatSymbols for the locale.
  • Eras - An array of strings corresponding to each possible value of the ERA field. If this key is not found in the bundle, the era names are inherited from the default DateFormatSymbols for the requested locale.

Parameters
cal Calendar: The calendar system whose date format symbols are desired.
locale Locale: The locale whose symbols are desired.

也可以看看：

DateFormatSymbols

Added in API level 24 
DateFormatSymbols (Calendar cal, 
                ULocale locale)

返回应该用于格式化给定语言环境中日历系统的日期的 DateFormatSymbols对象。

子类：
当创建一个新的日历的子类，你必须创建ResourceBundle包含其DateFormatSymbols在一个特定的地方。 资源包名称基于日历的完全指定的类名称，并在包名称末尾（类名前面）插入“.resources”，并在末尾附加“符号”。 例如，对应于“android.icu.util.HebrewCalendar”的包是“android.icu.impl.data.HebrewCalendarSymbols”。

在ResourceBundle中，该方法搜索五个密钥：

  • DayNames - An array of strings corresponding to each possible value of the DAY_OF_WEEK field. Even though DAY_OF_WEEK starts with SUNDAY = 1, This array is 0-based; the name for Sunday goes in the first position, at index 0. If this key is not found in the bundle, the day names are inherited from the default DateFormatSymbols for the requested locale.
  • DayAbbreviations - An array of abbreviated day names corresponding to the values in the "DayNames" array. If this key is not found in the resource bundle, the "DayNames" values are used instead. If neither key is found, the day abbreviations are inherited from the default DateFormatSymbols for the locale.
  • MonthNames - An array of strings corresponding to each possible value of the MONTH field. If this key is not found in the bundle, the month names are inherited from the default DateFormatSymbols for the requested locale.
  • MonthAbbreviations - An array of abbreviated day names corresponding to the values in the "MonthNames" array. If this key is not found in the resource bundle, the "MonthNames" values are used instead. If neither key is found, the day abbreviations are inherited from the default DateFormatSymbols for the locale.
  • Eras - An array of strings corresponding to each possible value of the ERA field. If this key is not found in the bundle, the era names are inherited from the default DateFormatSymbols for the requested locale.

Parameters
cal Calendar: The calendar system whose date format symbols are desired.
locale ULocale: The ulocale whose symbols are desired.

也可以看看：

DateFormatSymbols

Added in API level 24 
DateFormatSymbols (Class<? extends Calendar> calendarClass, 
                Locale locale)

使用Calendar类而不是Calendar实例的DateFormatSymbols（日历，区域设置）的变体。

Parameters
calendarClass Class
locale Locale

也可以看看：

DateFormatSymbols

Added in API level 24 
DateFormatSymbols (Class<? extends Calendar> calendarClass, 
                ULocale locale)

使用Calendar类而不是Calendar实例的DateFormatSymbols（Calendar，ULocale）的变体。

Parameters
calendarClass Class
locale ULocale

也可以看看：

DateFormatSymbols

Added in API level 24 
DateFormatSymbols (ResourceBundle bundle, 
                Locale locale)

从给定的资源包中提取自定义日历的DateFormatSymbols。 未覆盖的符号从语言环境的默认DateFormatSymbols继承。

Parameters
bundle ResourceBundle
locale Locale

也可以看看：

DateFormatSymbols

Added in API level 24 
DateFormatSymbols (ResourceBundle bundle, 
                ULocale locale)

从给定的资源包中提取自定义日历的DateFormatSymbols。 未覆盖的符号从语言环境的默认DateFormatSymbols继承。

Parameters
bundle ResourceBundle
locale ULocale

也可以看看：

Public methods

clone

Added in API level 24 
Object clone ()

覆盖克隆。

Returns
Object a clone of this instance.

equals

Added in API level 24 
boolean equals (Object obj)

覆盖等于。

Parameters
obj Object: the reference object with which to compare.
Returns
boolean true if this object is the same as the obj argument; false otherwise.

getAmPmStrings

Added in API level 24 
String[] getAmPmStrings ()

返回am / pm字符串。 例如：“AM”和“PM”。

Returns
String[] the weekday strings.

getAvailableLocales

Added in API level 24 
Locale[] getAvailableLocales ()

返回getInstance方法可返回本地化实例的所有语言环境的数组。 [icu]注意：与java.text.DateFormatSymbols#getAvailableLocales不同，此方法只返回Locale可用的Locale的数组。 目前，ICU不支持Java 6或其等效实现中引入的DateFormatSymbolsProvider 。

Returns
Locale[] An array of Locales for which localized DateFormatSymbols instances are available.

getEraNames

Added in API level 24 
String[] getEraNames ()

[icu]返回时代名称字符串。 例如：“Anno Domini”和“基督之前”。

Returns
String[] the era strings.

getEras

Added in API level 24 
String[] getEras ()

返回时代字符串。 例如：“AD”和“BC”。

Returns
String[] the era strings.

getInstance

Added in API level 24 
DateFormatSymbols getInstance ()

返回默认语言环境的DateFormatSymbols实例。 [icu]注意：与java.text.DateFormatSymbols#getInstance不同，此方法仅返回new android.icu.text.DateFormatSymbols() 。 ICU目前不支持Java 6或其等效实现中引入的DateFormatSymbolsProvider 。

Returns
DateFormatSymbols A DateFormatSymbols instance.

getInstance

Added in API level 24 
DateFormatSymbols getInstance (Locale locale)

返回给定语言环境的DateFormatSymbols实例。 [icu]注意：与java.text.DateFormatSymbols#getInstance不同，此方法仅返回new android.icu.text.DateFormatSymbols(locale) 。 目前，ICU不支持在Java 6或其等效实现中引入的DateFormatSymbolsProvider 。

Parameters
locale Locale: the locale.
Returns
DateFormatSymbols A DateFormatSymbols instance.

getInstance

Added in API level 24 
DateFormatSymbols getInstance (ULocale locale)

[icu]返回给定语言环境的DateFormatSymbols实例。 [icu]注意：与java.text.DateFormatSymbols#getInstance不同，此方法仅返回new android.icu.text.DateFormatSymbols(locale) 。 目前，ICU不支持在Java 6或其等效实现中引入的DateFormatSymbolsProvider 。

Parameters
locale ULocale: the locale.
Returns
DateFormatSymbols A DateFormatSymbols instance.

getLocalPatternChars

Added in API level 24 
String getLocalPatternChars ()

返回本地化的日期时间模式字符。 例如：'u'，'t'等。

注：ICU不再为开始ICU 3.8的地区提供本地化的日期 - 时间模式字符。 除非用户定义的本地化数据由setLocalPatternChars设置，否则此方法将返回非本地化的日期 - 时间模式字符。

Returns
String the localized date-time pattern characters.

getMonths

Added in API level 24 
String[] getMonths (int context, 
                int width)

返回月份字符串。 例如：“一月”，“二月”等。

Parameters
context int: The month context, FORMAT or STANDALONE.
width int: The width or the returned month string, either WIDE, ABBREVIATED, or NARROW.
Returns
String[] the month strings.

getMonths

Added in API level 24 
String[] getMonths ()

返回月份字符串。 例如：“一月”，“二月”等。

Returns
String[] the month strings.

getQuarters

Added in API level 24 
String[] getQuarters (int context, 
                int width)

[icu]返回季度字符串。 例如：“第一季度”，“第二季度”等

Parameters
context int: The quarter context, FORMAT or STANDALONE.
width int: The width or the returned quarter string, either WIDE or ABBREVIATED. There are no NARROW quarters.
Returns
String[] the quarter strings.

getShortMonths

Added in API level 24 
String[] getShortMonths ()

返回短月份字符串。 例如：“Jan”，“Feb”等。

Returns
String[] the short month strings.

getShortWeekdays

Added in API level 24 
String[] getShortWeekdays ()

返回缩写星期字符串; 例如：“太阳”，“星期一”等（注意：方法名称具有误导性;它没有得到CLDR式的“短”星期字符串，例如“苏”，“莫”等）

Returns
String[] the abbreviated weekday strings. Use Calendar.SUNDAY, Calendar.MONDAY, etc. to index the result array.

getWeekdays

Added in API level 24 
String[] getWeekdays (int context, 
                int width)

返回星期几字符串。 例如：“星期天”，“星期一”等。

Parameters
context int: Formatting context, either FORMAT or STANDALONE.
width int: Width of strings to be returned, either WIDE, ABBREVIATED, SHORT, or NARROW
Returns
String[] the weekday strings. Use Calendar.SUNDAY, Calendar.MONDAY, etc. to index the result array.

getWeekdays

Added in API level 24 
String[] getWeekdays ()

返回广泛的星期几字符串。 例如：“星期天”，“星期一”等。

Returns
String[] the weekday strings. Use Calendar.SUNDAY, Calendar.MONDAY, etc. to index the result array.

getYearNames

Added in API level 24 
String[] getYearNames (int context, 
                int width)

如果日历中包含它们，则返回循环年份名称字符串，例如：“嘉子”，“一周”等。

Parameters
context int: The usage context: FORMAT, STANDALONE.
width int: The requested name width: WIDE, ABBREVIATED, SHORT, NARROW.
Returns
String[] The year name strings, or null if they are not available for this calendar.

getZodiacNames

Added in API level 24 
String[] getZodiacNames (int context, 
                int width)

如果日历中包含日历，则返回日历生肖名称字符串，例如：“Rat”，“Ox”，“Tiger”等。

Parameters
context int: The usage context: FORMAT, STANDALONE.
width int: The requested name width: WIDE, ABBREVIATED, SHORT, NARROW.
Returns
String[] The zodiac name strings, or null if they are not available for this calendar.

getZoneStrings

Added in API level 24 
String[][] getZoneStrings ()

返回时区字符串。

该API返回的数组是一个二维的String数组，每行至少包含以下字符串：

  • ZoneStrings[n][0] - System time zone ID
  • ZoneStrings[n][1] - Long standard time display name
  • ZoneStrings[n][2] - Short standard time display name
  • ZoneStrings[n][3] - Long daylight saving time display name
  • ZoneStrings[n][4] - Short daylight saving time display name
When a localized display name is not available, the corresponding array element will be null.

注意 ：ICU实现由UTS#35 Unicode Locale Data Markup Language(LDML)指定的时区显示名称格式化算法。 该算法支持历史显示名称更改以及getZoneStrings()不提供的各种不同类型的名称。 要访问由ICU实现使用的全套时区字符串数据，您应该使用TimeZoneNames API。

Returns
String[][] the time zone strings.

hashCode

Added in API level 24 
int hashCode ()

覆盖hashCode。 为DateFormatSymbols对象生成一个哈希码。

Returns
int a hash code value for this object.

setAmPmStrings

Added in API level 24 
void setAmPmStrings (String[] newAmpms)

设置am / pm字符串。 例如：“AM”和“PM”。

Parameters
newAmpms String: the new ampm strings.

setEraNames

Added in API level 24 
void setEraNames (String[] newEraNames)

[icu]设置时代名称字符串。 例如：“Anno Domini”和“基督之前”。

Parameters
newEraNames String: the new era strings.

setEras

Added in API level 24 
void setEras (String[] newEras)

设置时代字符串。 例如：“AD”和“BC”。

Parameters
newEras String: the new era strings.

setLocalPatternChars

Added in API level 24 
void setLocalPatternChars (String newLocalPatternChars)

设置本地化的日期时间模式字符。 例如：'u'，'t'等。

Parameters
newLocalPatternChars String: the new localized date-time pattern characters.

setMonths

Added in API level 24 
void setMonths (String[] newMonths)

设置月份字符串。 例如：“一月”，“二月”等。

Parameters
newMonths String: the new month strings.

setMonths

Added in API level 24 
void setMonths (String[] newMonths, 
                int context, 
                int width)

设置月份字符串。 例如：“一月”，“二月”等。

Parameters
newMonths String: the new month strings.
context int: The formatting context, FORMAT or STANDALONE.
width int: The width of the month string, either WIDE, ABBREVIATED, or NARROW.

setQuarters

Added in API level 24 
void setQuarters (String[] newQuarters, 
                int context, 
                int width)

[icu]设置季度字符串。 例如：“第一季度”，“第二季度”等

Parameters
newQuarters String: the new quarter strings.
context int: The formatting context, FORMAT or STANDALONE.
width int: The width of the quarter string, either WIDE or ABBREVIATED. There are no NARROW quarters.

setShortMonths

Added in API level 24 
void setShortMonths (String[] newShortMonths)

设置短月份字符串。 例如：“Jan”，“Feb”等。

Parameters
newShortMonths String: the new short month strings.

setShortWeekdays

Added in API level 24 
void setShortWeekdays (String[] newAbbrevWeekdays)

设置缩短的星期几字符串; 例如：“太阳”，“星期一”等（注意：方法名称具有误导性;它不会设置CLDR风格的“简短”星期字符串，例如“Su”，“Mo”等）

Parameters
newAbbrevWeekdays String: the new abbreviated weekday strings. The array should be indexed by Calendar.SUNDAY, Calendar.MONDAY, etc.

setWeekdays

Added in API level 24 
void setWeekdays (String[] newWeekdays)

设置广泛的星期几字符串。 例如：“星期天”，“星期一”等。

Parameters
newWeekdays String: the new weekday strings. The array should be indexed by Calendar.SUNDAY, Calendar.MONDAY, etc.

setWeekdays

Added in API level 24 
void setWeekdays (String[] newWeekdays, 
                int context, 
                int width)

设置星期几字符串。 例如：“星期天”，“星期一”等。

Parameters
newWeekdays String: The new weekday strings.
context int: The formatting context, FORMAT or STANDALONE.
width int: The width of the strings, either WIDE, ABBREVIATED, SHORT, or NARROW.

setYearNames

Added in API level 24 
void setYearNames (String[] yearNames, 
                int context, 
                int width)

设置循环年份名称字符串，例如：“嘉子”，“一周”等。

Parameters
yearNames String: The new cyclic year name strings.
context int: The usage context: FORMAT, STANDALONE (currently only FORMAT is supported).
width int: The name width: WIDE, ABBREVIATED, NARROW (currently only ABBREVIATED is supported).

setZodiacNames

Added in API level 24 
void setZodiacNames (String[] zodiacNames, 
                int context, 
                int width)

设置日历生肖名称字符串，例如：“鼠”，“牛”，“虎”等。

Parameters
zodiacNames String: The new zodiac name strings.
context int: The usage context: FORMAT, STANDALONE (currently only FORMAT is supported).
width int: The name width: WIDE, ABBREVIATED, NARROW (currently only ABBREVIATED is supported).

setZoneStrings

Added in API level 24 
void setZoneStrings (String[][] newZoneStrings)

设置时区字符串。

注意 ： SimpleDateFormat不再使用存储在DateFormatSymbols的区域字符串。 因此，此方法设置的时区字符串在SimpleDateFormat格式化时区的实例中没有效果。 如果要自定义由SimpleDateFormat格式化的时区显示名称，则应该自定义TimeZoneFormat ，并将实例设置为setTimeZoneFormat(TimeZoneFormat) 。

Parameters
newZoneStrings String: the new time zone strings.

Protected methods

initializeData

Added in API level 24 
void initializeData (ULocale desiredLocale, 
                String type)

初始化区域设置和日历类型的格式符号

Parameters
desiredLocale ULocale: The locale whose symbols are desired.
type String: The calendar type whose date format symbols are desired.
Android开发手册

Hooray!