DateFormatSymbols

ABBREVIATED

int ABBREVIATED

[icu] Constant for width.

Constant Value: 0 (0x00000000)

FORMAT

int FORMAT

[icu] Constant for context.

Constant Value: 0 (0x00000000)

NARROW

int NARROW

[icu] Constant for width.

Constant Value: 2 (0x00000002)

SHORT

int SHORT

[icu] Constant for width; only supported for weekdays.

Constant Value: 3 (0x00000003)

STANDALONE

int STANDALONE

[icu] Constant for context.

Constant Value: 1 (0x00000001)

WIDE

int WIDE

[icu] Constant for width.

Constant Value: 1 (0x00000001)

DateFormatSymbols

DateFormatSymbols ()

Constructs a DateFormatSymbols object by loading format data from resources for the default FORMAT locale.

DateFormatSymbols

DateFormatSymbols (Locale locale)

Constructs a DateFormatSymbols object by loading format data from resources for the given locale.

DateFormatSymbols

DateFormatSymbols (ULocale locale)

[icu] Constructs a DateFormatSymbols object by loading format data from resources for the given ulocale.

DateFormatSymbols

DateFormatSymbols (Calendar cal, 
                Locale locale)

Returns the DateFormatSymbols object that should be used to format a calendar system's dates in the given locale.

Subclassing:
When creating a new Calendar subclass, you must create the ResourceBundle containing its DateFormatSymbols in a specific place. The resource bundle name is based on the calendar's fully-specified class name, with ".resources" inserted at the end of the package name (just before the class name) and "Symbols" appended to the end. For example, the bundle corresponding to "android.icu.util.HebrewCalendar" is "android.icu.impl.data.HebrewCalendarSymbols".

Within the ResourceBundle, this method searches for five keys:

• 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.

DateFormatSymbols

DateFormatSymbols (Calendar cal, 
                ULocale locale)

Returns the DateFormatSymbols object that should be used to format a calendar system's dates in the given locale.

Subclassing:
When creating a new Calendar subclass, you must create the ResourceBundle containing its DateFormatSymbols in a specific place. The resource bundle name is based on the calendar's fully-specified class name, with ".resources" inserted at the end of the package name (just before the class name) and "Symbols" appended to the end. For example, the bundle corresponding to "android.icu.util.HebrewCalendar" is "android.icu.impl.data.HebrewCalendarSymbols".

Within the ResourceBundle, this method searches for five keys:

• 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.

DateFormatSymbols

DateFormatSymbols (Class<? extends Calendar> calendarClass, 
                Locale locale)

Variant of DateFormatSymbols(Calendar, Locale) that takes the Calendar class instead of a Calendar instance.

DateFormatSymbols

DateFormatSymbols (Class<? extends Calendar> calendarClass, 
                ULocale locale)

Variant of DateFormatSymbols(Calendar, ULocale) that takes the Calendar class instead of a Calendar instance.

DateFormatSymbols

DateFormatSymbols (ResourceBundle bundle, 
                Locale locale)

Fetches a custom calendar's DateFormatSymbols out of the given resource bundle. Symbols that are not overridden are inherited from the default DateFormatSymbols for the locale.

DateFormatSymbols

DateFormatSymbols (ResourceBundle bundle, 
                ULocale locale)

Fetches a custom calendar's DateFormatSymbols out of the given resource bundle. Symbols that are not overridden are inherited from the default DateFormatSymbols for the locale.

clone

Object clone ()

Overrides clone.

equals

boolean equals (Object obj)

Overrides equals.

getAmPmStrings

String[] getAmPmStrings ()

Returns am/pm strings. For example: "AM" and "PM".

getAvailableLocales

Locale[] getAvailableLocales ()

Returns an array of all locales for which the getInstance methods of this class can return localized instances. [icu] Note: Unlike java.text.DateFormatSymbols#getAvailableLocales, this method simply returns the array of Locales available in this class. ICU does not support DateFormatSymbolsProvider introduced in Java 6 or its equivalent implementation for now.

getEraNames

String[] getEraNames ()

[icu] Returns era name strings. For example: "Anno Domini" and "Before Christ".

getEras

String[] getEras ()

Returns era strings. For example: "AD" and "BC".

getInstance

DateFormatSymbols getInstance ()

Returns a DateFormatSymbols instance for the default locale. [icu] Note: Unlike java.text.DateFormatSymbols#getInstance, this method simply returns new android.icu.text.DateFormatSymbols(). ICU does not support DateFormatSymbolsProvider introduced in Java 6 or its equivalent implementation for now.

getInstance

DateFormatSymbols getInstance (Locale locale)

Returns a DateFormatSymbols instance for the given locale. [icu] Note: Unlike java.text.DateFormatSymbols#getInstance, this method simply returns new android.icu.text.DateFormatSymbols(locale). ICU does not support DateFormatSymbolsProvider introduced in Java 6 or its equivalent implementation for now.

getInstance

DateFormatSymbols getInstance (ULocale locale)

[icu] Returns a DateFormatSymbols instance for the given locale. [icu] Note: Unlike java.text.DateFormatSymbols#getInstance, this method simply returns new android.icu.text.DateFormatSymbols(locale). ICU does not support DateFormatSymbolsProvider introduced in Java 6 or its equivalent implementation for now.

getLocalPatternChars

String getLocalPatternChars ()

Returns localized date-time pattern characters. For example: 'u', 't', etc.

Note: ICU no longer provides localized date-time pattern characters for a locale starting ICU 3.8. This method returns the non-localized date-time pattern characters unless user defined localized data is set by setLocalPatternChars.

getMonths

String[] getMonths (int context, 
                int width)

Returns month strings. For example: "January", "February", etc.

getMonths

String[] getMonths ()

Returns month strings. For example: "January", "February", etc.

getQuarters

String[] getQuarters (int context, 
                int width)

[icu] Returns quarter strings. For example: "1st Quarter", "2nd Quarter", etc.

getShortMonths

String[] getShortMonths ()

Returns short month strings. For example: "Jan", "Feb", etc.

getShortWeekdays

String[] getShortWeekdays ()

Returns abbreviated weekday strings; for example: "Sun", "Mon", etc. (Note: the method name is misleading; it does not get the CLDR-style "short" weekday strings, e.g. "Su", "Mo", etc.)

getWeekdays

String[] getWeekdays (int context, 
                int width)

Returns weekday strings. For example: "Sunday", "Monday", etc.

getWeekdays

String[] getWeekdays ()

Returns wide weekday strings. For example: "Sunday", "Monday", etc.

getYearNames

String[] getYearNames (int context, 
                int width)

Returns cyclic year name strings if the calendar has them, for example: "jia-zi", "yi-chou", etc.

getZodiacNames

String[] getZodiacNames (int context, 
                int width)

Returns calendar zodiac name strings if the calendar has them, for example: "Rat", "Ox", "Tiger", etc.

getZoneStrings

String[][] getZoneStrings ()

Returns time zone strings.

The array returned by this API is a two dimensional String array and each row contains at least following strings:

• 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

Note: ICU implements the time zone display name formatting algorithm specified by UTS#35 Unicode Locale Data Markup Language(LDML). The algorithm supports historic display name changes and various different types of names not available in getZoneStrings(). For accessing the full set of time zone string data used by ICU implementation, you should use TimeZoneNames APIs instead.

hashCode

int hashCode ()

Override hashCode. Generates a hash code for the DateFormatSymbols object.

setAmPmStrings

void setAmPmStrings (String[] newAmpms)

Sets am/pm strings. For example: "AM" and "PM".

setEraNames

void setEraNames (String[] newEraNames)

[icu] Sets era name strings. For example: "Anno Domini" and "Before Christ".

setEras

void setEras (String[] newEras)

Sets era strings. For example: "AD" and "BC".

setLocalPatternChars

void setLocalPatternChars (String newLocalPatternChars)

Sets localized date-time pattern characters. For example: 'u', 't', etc.

setMonths

void setMonths (String[] newMonths)

Sets month strings. For example: "January", "February", etc.

setMonths

void setMonths (String[] newMonths, 
                int context, 
                int width)

Sets month strings. For example: "January", "February", etc.

setQuarters

void setQuarters (String[] newQuarters, 
                int context, 
                int width)

[icu] Sets quarter strings. For example: "1st Quarter", "2nd Quarter", etc.

setShortMonths

void setShortMonths (String[] newShortMonths)

Sets short month strings. For example: "Jan", "Feb", etc.

setShortWeekdays

void setShortWeekdays (String[] newAbbrevWeekdays)

Sets abbreviated weekday strings; for example: "Sun", "Mon", etc. (Note: the method name is misleading; it does not set the CLDR-style "short" weekday strings, e.g. "Su", "Mo", etc.)

setWeekdays

void setWeekdays (String[] newWeekdays)

Sets wide weekday strings. For example: "Sunday", "Monday", etc.

setWeekdays

void setWeekdays (String[] newWeekdays, 
                int context, 
                int width)

Sets weekday strings. For example: "Sunday", "Monday", etc.

setYearNames

void setYearNames (String[] yearNames, 
                int context, 
                int width)

Sets cyclic year name strings, for example: "jia-zi", "yi-chou", etc.

setZodiacNames

void setZodiacNames (String[] zodiacNames, 
                int context, 
                int width)

Sets calendar zodiac name strings, for example: "Rat", "Ox", "Tiger", etc.

setZoneStrings

void setZoneStrings (String[][] newZoneStrings)

Sets time zone strings.

Note: SimpleDateFormat no longer uses the zone strings stored in a DateFormatSymbols. Therefore, the time zone strings set by this method have no effects in an instance of SimpleDateFormat for formatting time zones. If you want to customize time zone display names formatted by SimpleDateFormat, you should customize TimeZoneFormat and set the instance by setTimeZoneFormat(TimeZoneFormat) instead.

initializeData

void initializeData (ULocale desiredLocale, 
                String type)

Initializes format symbols for the locale and calendar type