/* | |
******************************************************************************* | |
* Copyright (C) 1996-2011, International Business Machines Corporation and * | |
* others. All Rights Reserved. * | |
******************************************************************************* | |
*/ | |
package com.ibm.icu.text; | |
import java.io.Serializable; | |
import java.util.Locale; | |
import java.util.MissingResourceException; | |
import java.util.ResourceBundle; | |
import com.ibm.icu.util.Calendar; | |
import com.ibm.icu.util.ULocale; | |
/** | |
* {@icuenhanced java.text.DateFormatSymbols}.{@icu _usage_} | |
* | |
* <p><code>DateFormatSymbols</code> is a public class for encapsulating | |
* localizable date-time formatting data, such as the names of the | |
* months, the names of the days of the week, and the time zone data. | |
* <code>DateFormat</code> and <code>SimpleDateFormat</code> both use | |
* <code>DateFormatSymbols</code> to encapsulate this information. | |
* | |
* <p>Typically you shouldn't use <code>DateFormatSymbols</code> directly. | |
* Rather, you are encouraged to create a date-time formatter with the | |
* <code>DateFormat</code> class's factory methods: <code>getTimeInstance</code>, | |
* <code>getDateInstance</code>, or <code>getDateTimeInstance</code>. | |
* These methods automatically create a <code>DateFormatSymbols</code> for | |
* the formatter so that you don't have to. After the | |
* formatter is created, you may modify its format pattern using the | |
* <code>setPattern</code> method. For more information about | |
* creating formatters using <code>DateFormat</code>'s factory methods, | |
* see {@link DateFormat}. | |
* | |
* <p>If you decide to create a date-time formatter with a specific | |
* format pattern for a specific locale, you can do so with: | |
* <blockquote> | |
* <pre> | |
* new SimpleDateFormat(aPattern, new DateFormatSymbols(aLocale)). | |
* </pre> | |
* </blockquote> | |
* | |
* <p><code>DateFormatSymbols</code> objects are clonable. When you obtain | |
* a <code>DateFormatSymbols</code> object, feel free to modify the | |
* date-time formatting data. For instance, you can replace the localized | |
* date-time format pattern characters with the ones that you feel easy | |
* to remember. Or you can change the representative cities | |
* to your favorite ones. | |
* | |
* <p>New <code>DateFormatSymbols</code> subclasses may be added to support | |
* <code>SimpleDateFormat</code> for date-time formatting for additional locales. | |
* | |
* @see DateFormat | |
* @see SimpleDateFormat | |
* @see com.ibm.icu.util.SimpleTimeZone | |
* @author Chen-Lieh Huang | |
* @stable ICU 2.0 | |
*/ | |
public class DateFormatSymbols implements Serializable, Cloneable { | |
private static final long serialVersionUID = 1L; | |
/** @internal */ | |
public java.text.DateFormatSymbols dfs; | |
/** @internal */ | |
public DateFormatSymbols(java.text.DateFormatSymbols delegate) { | |
this.dfs = delegate; | |
} | |
// TODO make sure local pattern char string is 18 characters long, | |
// that is, that it encompasses the new 'u' char for | |
// EXTENDED_YEAR. Two options: 1. Make sure resource data is | |
// correct; 2. Make code add in 'u' at end if len == 17. | |
// Constants for context | |
/** | |
* {@icu} Constant for context. | |
* @stable ICU 3.6 | |
*/ | |
public static final int FORMAT = 0; | |
/** | |
* {@icu} Constant for context. | |
* @stable ICU 3.6 | |
*/ | |
public static final int STANDALONE = 1; | |
/** | |
* {@icu} Constant for context. | |
* @internal | |
* @deprecated This API is ICU internal only. | |
*/ | |
public static final int DT_CONTEXT_COUNT = 2; | |
// Constants for width | |
/** | |
* {@icu} Constant for width. | |
* @stable ICU 3.6 | |
*/ | |
public static final int ABBREVIATED = 0; | |
/** | |
* {@icu} Constant for width. | |
* @stable ICU 3.6 | |
*/ | |
public static final int WIDE = 1; | |
/** | |
* {@icu} Constant for width. | |
* @stable ICU 3.6 | |
*/ | |
public static final int NARROW = 2; | |
/** | |
* {@icu} Constant for width. | |
* @internal | |
* @deprecated This API is ICU internal only. | |
*/ | |
public static final int DT_WIDTH_COUNT = 3; | |
/** | |
* Constructs a DateFormatSymbols object by loading format data from | |
* resources for the default locale. | |
* | |
* @throws java.util.MissingResourceException if the resources for the default locale | |
* cannot be found or cannot be loaded. | |
* @stable ICU 2.0 | |
*/ | |
public DateFormatSymbols() | |
{ | |
this(new java.text.DateFormatSymbols()); | |
} | |
/** | |
* Constructs a DateFormatSymbols object by loading format data from | |
* resources for the given locale. | |
* | |
* @throws java.util.MissingResourceException if the resources for the specified | |
* locale cannot be found or cannot be loaded. | |
* @stable ICU 2.0 | |
*/ | |
public DateFormatSymbols(Locale locale) | |
{ | |
this(new java.text.DateFormatSymbols(locale)); | |
} | |
/** | |
* {@icu} Constructs a DateFormatSymbols object by loading format data from | |
* resources for the given ulocale. | |
* | |
* @throws java.util.MissingResourceException if the resources for the specified | |
* locale cannot be found or cannot be loaded. | |
* @stable ICU 3.2 | |
*/ | |
public DateFormatSymbols(ULocale locale) | |
{ | |
this(new java.text.DateFormatSymbols(locale.toLocale())); | |
} | |
/** | |
* Returns a DateFormatSymbols instance for the default locale. | |
* | |
* {@icunote} Unlike <code>java.text.DateFormatSymbols#getInstance</code>, | |
* this method simply returns <code>new com.ibm.icu.text.DateFormatSymbols()</code>. | |
* ICU does not support <code>DateFormatSymbolsProvider</code> introduced in Java 6 | |
* or its equivalent implementation for now. | |
* | |
* @return A DateFormatSymbols instance. | |
* @stable ICU 3.8 | |
*/ | |
public static DateFormatSymbols getInstance() { | |
return new DateFormatSymbols(java.text.DateFormatSymbols.getInstance()); | |
} | |
/** | |
* Returns a DateFormatSymbols instance for the given locale. | |
* | |
* {@icunote} Unlike <code>java.text.DateFormatSymbols#getInstance</code>, | |
* this method simply returns <code>new com.ibm.icu.text.DateFormatSymbols(locale)</code>. | |
* ICU does not support <code>DateFormatSymbolsProvider</code> introduced in Java 6 | |
* or its equivalent implementation for now. | |
* | |
* @param locale the locale. | |
* @return A DateFormatSymbols instance. | |
* @stable ICU 3.8 | |
*/ | |
public static DateFormatSymbols getInstance(Locale locale) { | |
return new DateFormatSymbols(java.text.DateFormatSymbols.getInstance(locale)); | |
} | |
/** | |
* {@icu} Returns a DateFormatSymbols instance for the given locale. | |
* | |
* {@icunote} Unlike <code>java.text.DateFormatSymbols#getInstance</code>, | |
* this method simply returns <code>new com.ibm.icu.text.DateFormatSymbols(locale)</code>. | |
* ICU does not support <code>DateFormatSymbolsProvider</code> introduced in Java 6 | |
* or its equivalent implementation for now. | |
* | |
* @param locale the locale. | |
* @return A DateFormatSymbols instance. | |
* @stable ICU 3.8 | |
*/ | |
public static DateFormatSymbols getInstance(ULocale locale) { | |
return new DateFormatSymbols(java.text.DateFormatSymbols.getInstance(locale.toLocale())); | |
} | |
/** | |
* Returns an array of all locales for which the <code>getInstance</code> methods of | |
* this class can return localized instances. | |
* | |
* {@icunote} Unlike <code>java.text.DateFormatSymbols#getAvailableLocales</code>, | |
* this method simply returns the array of <code>Locale</code>s available in this | |
* class. ICU does not support <code>DateFormatSymbolsProvider</code> introduced in | |
* Java 6 or its equivalent implementation for now. | |
* | |
* @return An array of <code>Locale</code>s for which localized | |
* <code>DateFormatSymbols</code> instances are available. | |
* @stable ICU 3.8 | |
*/ | |
public static Locale[] getAvailableLocales() { | |
return java.text.DateFormatSymbols.getAvailableLocales(); | |
} | |
/** | |
* {@icu} Returns an array of all locales for which the <code>getInstance</code> | |
* methods of this class can return localized instances. | |
* | |
* {@icunote} Unlike <code>java.text.DateFormatSymbols#getAvailableLocales</code>, | |
* this method simply returns the array of <code>ULocale</code>s available in this | |
* class. ICU does not support <code>DateFormatSymbolsProvider</code> introduced in | |
* Java 6 or its equivalent implementation for now. | |
* | |
* @return An array of <code>ULocale</code>s for which localized | |
* <code>DateFormatSymbols</code> instances are available. | |
* @draft ICU 3.8 (retain) | |
* @provisional This API might change or be removed in a future release. | |
*/ | |
public static ULocale[] getAvailableULocales() { | |
Locale[] locales = java.text.DateFormatSymbols.getAvailableLocales(); | |
ULocale[] ulocales = new ULocale[locales.length]; | |
for (int i = 0; i < locales.length; ++i) { | |
ulocales[i] = ULocale.forLocale(locales[i]); | |
} | |
return ulocales; | |
} | |
/** | |
* Returns era strings. For example: "AD" and "BC". | |
* @return the era strings. | |
* @stable ICU 2.0 | |
*/ | |
public String[] getEras() { | |
return dfs.getEras(); | |
} | |
/** | |
* Sets era strings. For example: "AD" and "BC". | |
* @param newEras the new era strings. | |
* @stable ICU 2.0 | |
*/ | |
public void setEras(String[] newEras) { | |
dfs.setEras(newEras); | |
} | |
/** | |
* {@icu} Returns era name strings. For example: "Anno Domini" and "Before Christ". | |
* @return the era strings. | |
* @stable ICU 3.4 | |
*/ | |
public String[] getEraNames() { | |
return getEras(); // Java has no distinction between era strings and era name strings | |
} | |
/** | |
* {@icu} Sets era name strings. For example: "Anno Domini" and "Before Christ". | |
* @param newEraNames the new era strings. | |
* @stable ICU 3.8 | |
*/ | |
public void setEraNames(String[] newEraNames) { | |
setEras(newEraNames); // Java has no distinction between era strings and era name strings | |
} | |
/** | |
* Returns month strings. For example: "January", "February", etc. | |
* @return the month strings. | |
* @stable ICU 2.0 | |
*/ | |
public String[] getMonths() { | |
return dfs.getMonths(); | |
} | |
/** | |
* Returns month strings. For example: "January", "February", etc. | |
* @param context The month context, FORMAT or STANDALONE. | |
* @param width The width or the returned month string, | |
* either WIDE, ABBREVIATED, or NARROW. | |
* @return the month strings. | |
* @stable ICU 3.4 | |
*/ | |
public String[] getMonths(int context, int width) { | |
// JDK does not support context / narrow months | |
switch (width) { | |
case WIDE: | |
return dfs.getMonths(); | |
case ABBREVIATED: | |
case NARROW: | |
return dfs.getShortMonths(); | |
default: | |
throw new IllegalArgumentException("Unsupported width argument value"); | |
} | |
} | |
/** | |
* Sets month strings. For example: "January", "February", etc. | |
* @param newMonths the new month strings. | |
* @stable ICU 2.0 | |
*/ | |
public void setMonths(String[] newMonths) { | |
dfs.setMonths(newMonths); | |
} | |
/** | |
* Sets month strings. For example: "January", "February", etc. | |
* @param newMonths the new month strings. | |
* @param context The formatting context, FORMAT or STANDALONE. | |
* @param width The width of the month string, | |
* either WIDE, ABBREVIATED, or NARROW. | |
* @stable ICU 3.8 | |
*/ | |
public void setMonths(String[] newMonths, int context, int width) { | |
// JDK does not support context / narrow months | |
switch (width) { | |
case WIDE: | |
dfs.setMonths(newMonths); | |
break; | |
case ABBREVIATED: | |
case NARROW: | |
dfs.setShortMonths(newMonths); | |
break; | |
default: | |
throw new IllegalArgumentException("Unsupported width argument value"); | |
} | |
} | |
/** | |
* Returns short month strings. For example: "Jan", "Feb", etc. | |
* @return the short month strings. | |
* @stable ICU 2.0 | |
*/ | |
public String[] getShortMonths() { | |
return dfs.getShortMonths(); | |
} | |
/** | |
* Sets short month strings. For example: "Jan", "Feb", etc. | |
* @param newShortMonths the new short month strings. | |
* @stable ICU 2.0 | |
*/ | |
public void setShortMonths(String[] newShortMonths) { | |
dfs.setShortMonths(newShortMonths); | |
} | |
/** | |
* Returns weekday strings. For example: "Sunday", "Monday", etc. | |
* @return the weekday strings. Use <code>Calendar.SUNDAY</code>, | |
* <code>Calendar.MONDAY</code>, etc. to index the result array. | |
* @stable ICU 2.0 | |
*/ | |
public String[] getWeekdays() { | |
return dfs.getWeekdays(); | |
} | |
/** | |
* Returns weekday strings. For example: "Sunday", "Monday", etc. | |
* @return the weekday strings. Use <code>Calendar.SUNDAY</code>, | |
* <code>Calendar.MONDAY</code>, etc. to index the result array. | |
* @param context Formatting context, either FORMAT or STANDALONE. | |
* @param width Width of strings to be returned, either | |
* WIDE, ABBREVIATED, or NARROW | |
* @stable ICU 3.4 | |
*/ | |
public String[] getWeekdays(int context, int width) { | |
// JDK does not support context / narrow weekdays | |
switch (width) { | |
case WIDE: | |
return dfs.getWeekdays(); | |
case ABBREVIATED: | |
case NARROW: | |
return dfs.getShortWeekdays(); | |
default: | |
throw new IllegalArgumentException("Unsupported width argument value"); | |
} | |
} | |
/** | |
* Sets weekday strings. For example: "Sunday", "Monday", etc. | |
* @param newWeekdays The new weekday strings. | |
* @param context The formatting context, FORMAT or STANDALONE. | |
* @param width The width of the strings, | |
* either WIDE, ABBREVIATED, or NARROW. | |
* @stable ICU 3.8 | |
*/ | |
public void setWeekdays(String[] newWeekdays, int context, int width) { | |
// JDK does not support context / narrow weekdays | |
switch (width) { | |
case WIDE: | |
dfs.setWeekdays(newWeekdays); | |
break; | |
case ABBREVIATED: | |
case NARROW: | |
dfs.setShortWeekdays(newWeekdays); | |
break; | |
default: | |
throw new IllegalArgumentException("Unsupported width argument value"); | |
} | |
} | |
/** | |
* Sets weekday strings. For example: "Sunday", "Monday", etc. | |
* @param newWeekdays the new weekday strings. The array should | |
* be indexed by <code>Calendar.SUNDAY</code>, | |
* <code>Calendar.MONDAY</code>, etc. | |
* @stable ICU 2.0 | |
*/ | |
public void setWeekdays(String[] newWeekdays) { | |
dfs.setWeekdays(newWeekdays); | |
} | |
/** | |
* Returns short weekday strings. For example: "Sun", "Mon", etc. | |
* @return the short weekday strings. Use <code>Calendar.SUNDAY</code>, | |
* <code>Calendar.MONDAY</code>, etc. to index the result array. | |
* @stable ICU 2.0 | |
*/ | |
public String[] getShortWeekdays() { | |
return dfs.getShortWeekdays(); | |
} | |
/** | |
* Sets short weekday strings. For example: "Sun", "Mon", etc. | |
* @param newShortWeekdays the new short weekday strings. The array should | |
* be indexed by <code>Calendar.SUNDAY</code>, | |
* <code>Calendar.MONDAY</code>, etc. | |
* @stable ICU 2.0 | |
*/ | |
public void setShortWeekdays(String[] newShortWeekdays) { | |
dfs.setShortWeekdays(newShortWeekdays); | |
} | |
/** | |
* {@icu} Returns quarter strings. For example: "1st Quarter", "2nd Quarter", etc. | |
* @param context The quarter context, FORMAT or STANDALONE. | |
* @param width The width or the returned quarter string, | |
* either WIDE or ABBREVIATED. There are no NARROW quarters. | |
* @return the quarter strings. | |
* @stable ICU 3.6 | |
*/ | |
public String[] getQuarters(int context, int width) { | |
throw new UnsupportedOperationException("Method not supported by com.ibm.icu.base"); | |
} | |
/** | |
* {@icu} Sets quarter strings. For example: "1st Quarter", "2nd Quarter", etc. | |
* @param newQuarters the new quarter strings. | |
* @param context The formatting context, FORMAT or STANDALONE. | |
* @param width The width of the quarter string, | |
* either WIDE or ABBREVIATED. There are no NARROW quarters. | |
* @stable ICU 3.8 | |
*/ | |
public void setQuarters(String[] newQuarters, int context, int width) { | |
throw new UnsupportedOperationException("Method not supported by com.ibm.icu.base"); | |
} | |
/** | |
* Returns am/pm strings. For example: "AM" and "PM". | |
* @return the weekday strings. | |
* @stable ICU 2.0 | |
*/ | |
public String[] getAmPmStrings() { | |
return dfs.getAmPmStrings(); | |
} | |
/** | |
* Sets am/pm strings. For example: "AM" and "PM". | |
* @param newAmpms the new ampm strings. | |
* @stable ICU 2.0 | |
*/ | |
public void setAmPmStrings(String[] newAmpms) { | |
dfs.setAmPmStrings(newAmpms); | |
} | |
/** | |
* Returns timezone strings. | |
* @return the timezone strings. | |
* @stable ICU 2.0 | |
*/ | |
public String[][] getZoneStrings() { | |
return dfs.getZoneStrings(); | |
} | |
/** | |
* Sets timezone strings. | |
* @param newZoneStrings the new timezone strings. | |
* @stable ICU 2.0 | |
*/ | |
public void setZoneStrings(String[][] newZoneStrings) { | |
dfs.setZoneStrings(newZoneStrings); | |
} | |
/** | |
* Returns localized date-time pattern characters. For example: 'u', 't', etc. | |
* | |
* <p>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. | |
* @return the localized date-time pattern characters. | |
* @stable ICU 2.0 | |
*/ | |
public String getLocalPatternChars() { | |
return dfs.getLocalPatternChars(); | |
} | |
/** | |
* Sets localized date-time pattern characters. For example: 'u', 't', etc. | |
* @param newLocalPatternChars the new localized date-time | |
* pattern characters. | |
* @stable ICU 2.0 | |
*/ | |
public void setLocalPatternChars(String newLocalPatternChars) { | |
dfs.setLocalPatternChars(newLocalPatternChars); | |
} | |
/** | |
* Overrides clone. | |
* @stable ICU 2.0 | |
*/ | |
public Object clone() | |
{ | |
return new DateFormatSymbols((java.text.DateFormatSymbols)dfs.clone()); | |
} | |
/** | |
* Override hashCode. | |
* Generates a hash code for the DateFormatSymbols object. | |
* @stable ICU 2.0 | |
*/ | |
public int hashCode() { | |
return dfs.hashCode(); | |
} | |
/** | |
* Overrides equals. | |
* @stable ICU 2.0 | |
*/ | |
public boolean equals(Object obj) | |
{ | |
try { | |
return dfs.equals(((DateFormatSymbols)obj).dfs); | |
} | |
catch (Exception e) { | |
return false; | |
} | |
} | |
//~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
/** | |
* Returns the {@link DateFormatSymbols} object that should be used to format a | |
* calendar system's dates in the given locale. | |
* <p> | |
* <b>Subclassing:</b><br> | |
* When creating a new Calendar subclass, you must create the | |
* {@link ResourceBundle ResourceBundle} | |
* containing its {@link DateFormatSymbols 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 "com.ibm.icu.util.HebrewCalendar" | |
* is "com.ibm.icu.impl.data.HebrewCalendarSymbols". | |
* <p> | |
* Within the ResourceBundle, this method searches for five keys: | |
* <ul> | |
* <li><b>DayNames</b> - | |
* An array of strings corresponding to each possible | |
* value of the <code>DAY_OF_WEEK</code> field. Even though | |
* <code>DAY_OF_WEEK</code> starts with <code>SUNDAY</code> = 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 <code>DateFormatSymbols</code> for the requested locale. | |
* | |
* <li><b>DayAbbreviations</b> - | |
* 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 | |
* <code>DateFormatSymbols</code> for the locale. | |
* | |
* <li><b>MonthNames</b> - | |
* An array of strings corresponding to each possible | |
* value of the <code>MONTH</code> field. If this key is not found | |
* in the bundle, the month names are inherited from the | |
* default <code>DateFormatSymbols</code> for the requested locale. | |
* | |
* <li><b>MonthAbbreviations</b> - | |
* 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 | |
* <code>DateFormatSymbols</code> for the locale. | |
* | |
* <li><b>Eras</b> - | |
* An array of strings corresponding to each possible | |
* value of the <code>ERA</code> field. If this key is not found | |
* in the bundle, the era names are inherited from the | |
* default <code>DateFormatSymbols</code> for the requested locale. | |
* </ul> | |
* <p> | |
* @param cal The calendar system whose date format symbols are desired. | |
* @param locale The locale whose symbols are desired. | |
* | |
* @see DateFormatSymbols#DateFormatSymbols(java.util.Locale) | |
* @stable ICU 2.0 | |
*/ | |
public DateFormatSymbols(Calendar cal, Locale locale) { | |
throw new UnsupportedOperationException("Constructor not supported by com.ibm.icu.base"); | |
} | |
/** | |
* Returns the {@link DateFormatSymbols} object that should be used to format a | |
* calendar system's dates in the given locale. | |
* <p> | |
* <b>Subclassing:</b><br> | |
* When creating a new Calendar subclass, you must create the | |
* {@link ResourceBundle ResourceBundle} | |
* containing its {@link DateFormatSymbols 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 "com.ibm.icu.util.HebrewCalendar" | |
* is "com.ibm.icu.impl.data.HebrewCalendarSymbols". | |
* <p> | |
* Within the ResourceBundle, this method searches for five keys: | |
* <ul> | |
* <li><b>DayNames</b> - | |
* An array of strings corresponding to each possible | |
* value of the <code>DAY_OF_WEEK</code> field. Even though | |
* <code>DAY_OF_WEEK</code> starts with <code>SUNDAY</code> = 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 <code>DateFormatSymbols</code> for the requested locale. | |
* | |
* <li><b>DayAbbreviations</b> - | |
* 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 | |
* <code>DateFormatSymbols</code> for the locale. | |
* | |
* <li><b>MonthNames</b> - | |
* An array of strings corresponding to each possible | |
* value of the <code>MONTH</code> field. If this key is not found | |
* in the bundle, the month names are inherited from the | |
* default <code>DateFormatSymbols</code> for the requested locale. | |
* | |
* <li><b>MonthAbbreviations</b> - | |
* 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 | |
* <code>DateFormatSymbols</code> for the locale. | |
* | |
* <li><b>Eras</b> - | |
* An array of strings corresponding to each possible | |
* value of the <code>ERA</code> field. If this key is not found | |
* in the bundle, the era names are inherited from the | |
* default <code>DateFormatSymbols</code> for the requested locale. | |
* </ul> | |
* <p> | |
* @param cal The calendar system whose date format symbols are desired. | |
* @param locale The ulocale whose symbols are desired. | |
* | |
* @see DateFormatSymbols#DateFormatSymbols(java.util.Locale) | |
* @stable ICU 3.2 | |
*/ | |
public DateFormatSymbols(Calendar cal, ULocale locale) { | |
throw new UnsupportedOperationException("Constructor not supported by com.ibm.icu.base"); | |
} | |
/** | |
* Variant of DateFormatSymbols(Calendar, Locale) that takes the Calendar class | |
* instead of a Calandar instance. | |
* @see #DateFormatSymbols(Calendar, Locale) | |
* @stable ICU 2.2 | |
*/ | |
public DateFormatSymbols(Class<? extends Calendar> calendarClass, Locale locale) { | |
throw new UnsupportedOperationException("Constructor not supported by com.ibm.icu.base"); | |
} | |
/** | |
* Variant of DateFormatSymbols(Calendar, ULocale) that takes the Calendar class | |
* instead of a Calandar instance. | |
* @see #DateFormatSymbols(Calendar, Locale) | |
* @stable ICU 3.2 | |
*/ | |
public DateFormatSymbols(Class<? extends Calendar> calendarClass, ULocale locale) { | |
throw new UnsupportedOperationException("Constructor not supported by com.ibm.icu.base"); | |
} | |
/** | |
* 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. | |
* @see DateFormatSymbols#DateFormatSymbols(java.util.Locale) | |
* @stable ICU 2.0 | |
*/ | |
public DateFormatSymbols(ResourceBundle bundle, Locale locale) { | |
throw new UnsupportedOperationException("Constructor not supported by com.ibm.icu.base"); | |
} | |
/** | |
* 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. | |
* @see DateFormatSymbols#DateFormatSymbols(java.util.Locale) | |
* @stable ICU 3.2 | |
*/ | |
public DateFormatSymbols(ResourceBundle bundle, ULocale locale) { | |
throw new UnsupportedOperationException("Constructor not supported by com.ibm.icu.base"); | |
} | |
/** | |
* Finds the ResourceBundle containing the date format information for | |
* a specified calendar subclass in a given locale. | |
* <p> | |
* 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 "com.ibm.icu.util.HebrewCalendar" | |
* is "com.ibm.icu.impl.data.HebrewCalendarSymbols". | |
* <p> | |
* <b>Note:</b>Because of the structural changes in the ICU locale bundle, | |
* this API no longer works as described. This method always returns null. | |
* @deprecated ICU 4.0 | |
*/ | |
// This API was formerly @stable ICU 2.0 | |
static public ResourceBundle getDateFormatBundle(Class<? extends Calendar> calendarClass, | |
Locale locale) throws MissingResourceException { | |
throw new UnsupportedOperationException("Method not supported by com.ibm.icu.base"); } | |
/** | |
* Finds the ResourceBundle containing the date format information for | |
* a specified calendar subclass in a given locale. | |
* <p> | |
* 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 "com.ibm.icu.util.HebrewCalendar" | |
* is "com.ibm.icu.impl.data.HebrewCalendarSymbols". | |
* <p> | |
* <b>Note:</b>Because of the structural changes in the ICU locale bundle, | |
* this API no longer works as described. This method always returns null. | |
* @deprecated ICU 4.0 | |
*/ | |
// This API was formerly @stable ICU 3.2 | |
static public ResourceBundle getDateFormatBundle(Class<? extends Calendar> calendarClass, | |
ULocale locale) throws MissingResourceException { | |
throw new UnsupportedOperationException("Method not supported by com.ibm.icu.base"); } | |
/** | |
* Variant of getDateFormatBundle(java.lang.Class, java.util.Locale) that takes | |
* a Calendar instance instead of a Calendar class. | |
* <p> | |
* <b>Note:</b>Because of the structural changes in the ICU locale bundle, | |
* this API no longer works as described. This method always returns null. | |
* @see #getDateFormatBundle(java.lang.Class, java.util.Locale) | |
* @deprecated ICU 4.0 | |
*/ | |
// This API was formerly @stable ICU 2.2 | |
public static ResourceBundle getDateFormatBundle(Calendar cal, Locale locale) throws MissingResourceException { | |
throw new UnsupportedOperationException("Method not supported by com.ibm.icu.base"); } | |
/** | |
* Variant of getDateFormatBundle(java.lang.Class, java.util.Locale) that takes | |
* a Calendar instance instead of a Calendar class. | |
* <p> | |
* <b>Note:</b>Because of the structural changes in the ICU locale bundle, | |
* this API no longer works as described. This method always returns null. | |
* @see #getDateFormatBundle(java.lang.Class, java.util.Locale) | |
* @deprecated ICU 4.0 | |
*/ | |
// This API was formerly @stable ICU 3.2 | |
public static ResourceBundle getDateFormatBundle(Calendar cal, ULocale locale) throws MissingResourceException { | |
throw new UnsupportedOperationException("Method not supported by com.ibm.icu.base"); } | |
/** | |
* Returns the locale that was used to create this object, or null. | |
* This may may differ from the locale requested at the time of | |
* this object's creation. For example, if an object is created | |
* for locale <tt>en_US_CALIFORNIA</tt>, the actual data may be | |
* drawn from <tt>en</tt> (the <i>actual</i> locale), and | |
* <tt>en_US</tt> may be the most specific locale that exists (the | |
* <i>valid</i> locale). | |
* | |
* <p>Note: This method will be implemented in ICU 3.0; ICU 2.8 | |
* contains a partial preview implementation. The * <i>actual</i> | |
* locale is returned correctly, but the <i>valid</i> locale is | |
* not, in most cases. | |
* @param type type of information requested, either {@link | |
* com.ibm.icu.util.ULocale#VALID_LOCALE} or {@link | |
* com.ibm.icu.util.ULocale#ACTUAL_LOCALE}. | |
* @return the information specified by <i>type</i>, or null if | |
* this object was not constructed from locale data. | |
* @see com.ibm.icu.util.ULocale | |
* @see com.ibm.icu.util.ULocale#VALID_LOCALE | |
* @see com.ibm.icu.util.ULocale#ACTUAL_LOCALE | |
* @draft ICU 2.8 (retain) | |
* @provisional This API might change or be removed in a future release. | |
*/ | |
public final ULocale getLocale(ULocale.Type type) { | |
throw new UnsupportedOperationException("Method not supported by com.ibm.icu.base"); | |
} | |
} |