/**
* This method sets the formatting pattern that should be used by this object. This string is
* localized.
*
* @param pattern The new format pattern.
* @throws NullPointerException if the pattern is null.
* @throws IllegalArgumentException if the pattern is invalid.
*/
public void applyLocalizedPattern(String pattern) {
String localChars = formatData.getLocalPatternChars();
pattern = translateLocalizedPattern(pattern, localChars, standardChars);
applyPattern(pattern);
}
/**
* This method returns a string with the formatting pattern being used by this object. This string
* is localized.
*
* @return The format string.
*/
public String toLocalizedPattern() {
String localChars = formatData.getLocalPatternChars();
return translateLocalizedPattern(pattern, standardChars, localChars);
}
/**
* Returns the pattern of this simple date format using localized pattern characters.
*
* @return the localized pattern.
*/
public String toLocalizedPattern() {
return convertPattern(pattern, PATTERN_CHARS, formatData.getLocalPatternChars(), false);
}
/**
* Changes the pattern of this simple date format to the specified pattern which uses localized
* pattern characters.
*
* @param template the localized pattern.
*/
public void applyLocalizedPattern(String template) {
pattern = convertPattern(template, formatData.getLocalPatternChars(), PATTERN_CHARS, true);
}
static String describeLocale(String name) {
final StringBuilder result = new StringBuilder();
result.append("<html>");
final Locale locale = localeByName(name);
result.append("<p>");
append(result, "Display Name", locale.getDisplayName());
append(result, "Localized Display Name", locale.getDisplayName(locale));
if (locale.getLanguage().length() > 0) {
String iso3Language = "(not available)";
try {
iso3Language = locale.getISO3Language();
} catch (MissingResourceException ignored) {
}
result.append("<p>");
append(result, "Display Language", locale.getDisplayLanguage());
append(result, "Localized Display Language", locale.getDisplayLanguage(locale));
append(result, "2-Letter Language Code", locale.getLanguage());
append(result, "3-Letter Language Code", iso3Language);
}
if (locale.getCountry().length() > 0) {
String iso3Country = "(not available)";
try {
iso3Country = locale.getISO3Country();
} catch (MissingResourceException ignored) {
}
result.append("<p>");
append(result, "Display Country", locale.getDisplayCountry());
append(result, "Localized Display Country", locale.getDisplayCountry(locale));
append(result, "2-Letter Country Code", locale.getCountry());
append(result, "3-Letter Country Code", iso3Country);
}
if (locale.getVariant().length() > 0) {
result.append("<p>");
append(result, "Display Variant", locale.getDisplayVariant());
append(result, "Localized Display Variant", locale.getDisplayVariant(locale));
append(result, "Variant Code", locale.getVariant());
}
result.append("<p><b>Number Formatting</b>");
describeNumberFormat(result, "Decimal", NumberFormat.getInstance(locale), 1234.5, -1234.5);
describeNumberFormat(result, "Integer", NumberFormat.getIntegerInstance(locale), 1234, -1234);
describeNumberFormat(
result, "Currency", NumberFormat.getCurrencyInstance(locale), 1234.5, -1234.5);
describeNumberFormat(result, "Percent", NumberFormat.getPercentInstance(locale), 12.3);
boolean hasLocaleData = hasLocaleData();
if (!hasLocaleData) {
result.append("<p><b>Decimal Format Symbols</b>");
NumberFormat nf = NumberFormat.getInstance(locale);
if (nf instanceof DecimalFormat) {
describeDecimalFormatSymbols(result, ((DecimalFormat) nf).getDecimalFormatSymbols());
} else {
result.append("(Didn't expect " + nf.getClass() + ".)");
}
}
Date now =
new Date(); // FIXME: it might be more useful to always show a time in the afternoon, to
// make 24-hour patterns more obvious.
result.append("<p><b>Date/Time Formatting</b>");
describeDateFormat(
result, "Full Date", DateFormat.getDateInstance(DateFormat.FULL, locale), now);
describeDateFormat(
result, "Long Date", DateFormat.getDateInstance(DateFormat.LONG, locale), now);
describeDateFormat(
result, "Medium Date", DateFormat.getDateInstance(DateFormat.MEDIUM, locale), now);
describeDateFormat(
result, "Short Date", DateFormat.getDateInstance(DateFormat.SHORT, locale), now);
result.append("<p>");
describeDateFormat(
result, "Full Time", DateFormat.getTimeInstance(DateFormat.FULL, locale), now);
describeDateFormat(
result, "Long Time", DateFormat.getTimeInstance(DateFormat.LONG, locale), now);
describeDateFormat(
result, "Medium Time", DateFormat.getTimeInstance(DateFormat.MEDIUM, locale), now);
describeDateFormat(
result, "Short Time", DateFormat.getTimeInstance(DateFormat.SHORT, locale), now);
result.append("<p>");
describeDateFormat(
result,
"Full Date/Time",
DateFormat.getDateTimeInstance(DateFormat.FULL, DateFormat.FULL, locale),
now);
describeDateFormat(
result,
"Long Date/Time",
DateFormat.getDateTimeInstance(DateFormat.LONG, DateFormat.LONG, locale),
now);
describeDateFormat(
result,
"Medium Date/Time",
DateFormat.getDateTimeInstance(DateFormat.MEDIUM, DateFormat.MEDIUM, locale),
now);
describeDateFormat(
result,
"Short Date/Time",
DateFormat.getDateTimeInstance(DateFormat.SHORT, DateFormat.SHORT, locale),
now);
if (!hasLocaleData) {
result.append("<p><b>Date Format Symbols</b><p>");
DateFormat edf = DateFormat.getDateInstance(DateFormat.FULL, Locale.US);
DateFormatSymbols edfs = ((SimpleDateFormat) edf).getDateFormatSymbols();
DateFormat df = DateFormat.getDateInstance(DateFormat.FULL, locale);
DateFormatSymbols dfs = ((SimpleDateFormat) df).getDateFormatSymbols();
append(result, "Local Pattern Chars", dfs.getLocalPatternChars());
append(result, "Am/pm", Arrays.toString(dfs.getAmPmStrings()));
append(result, "Eras", Arrays.toString(dfs.getEras()));
append(result, "Months", Arrays.toString(dfs.getMonths()));
append(result, "Short Months", Arrays.toString(dfs.getShortMonths()));
append(result, "Weekdays", Arrays.toString(dfs.getWeekdays()));
append(result, "Short Weekdays", Arrays.toString(dfs.getShortWeekdays()));
}
result.append("<p><b>Calendar</b><p>");
Calendar c = Calendar.getInstance(locale);
int firstDayOfWeek = c.getFirstDayOfWeek();
String firstDayOfWeekString = new DateFormatSymbols(locale).getWeekdays()[firstDayOfWeek];
String englishFirstDayOfWeekString =
new DateFormatSymbols(Locale.US).getWeekdays()[firstDayOfWeek];
String firstDayOfWeekDetails = firstDayOfWeek + " '" + firstDayOfWeekString + "'";
if (!englishFirstDayOfWeekString.equals(firstDayOfWeekString)) {
firstDayOfWeekDetails += " (" + englishFirstDayOfWeekString + ")";
}
append(result, "First Day of the Week", firstDayOfWeekDetails);
append(result, "Minimal Days in First Week", c.getMinimalDaysInFirstWeek());
// If this locale specifies a country, check out the currency.
// Languages don't have currencies; countries do.
if (!locale.getCountry().equals("")) {
result.append("<p><b>Currency</b><p>");
try {
Currency currency = Currency.getInstance(locale);
append(result, "ISO 4217 Currency Code", currency.getCurrencyCode());
append(
result,
"Currency Symbol",
unicodeString(currency.getSymbol(locale)) + " (" + currency.getSymbol(Locale.US) + ")");
append(result, "Default Fraction Digits", currency.getDefaultFractionDigits());
} catch (IllegalArgumentException ex) {
result.append(
"<p>(This version of Android is unable to return a Currency for this Locale.)");
}
}
result.append("<p><b>Data Availability</b><p>");
appendAvailability(result, locale, "BreakIterator", BreakIterator.class);
appendAvailability(result, locale, "Calendar", NumberFormat.class);
appendAvailability(result, locale, "Collator", Collator.class);
appendAvailability(result, locale, "DateFormat", DateFormat.class);
appendAvailability(result, locale, "DateFormatSymbols", DateFormatSymbols.class);
appendAvailability(result, locale, "DecimalFormatSymbols", DecimalFormatSymbols.class);
appendAvailability(result, locale, "NumberFormat", NumberFormat.class);
if (hasLocaleData) {
result.append("<p><b>libcore.icu.LocaleData</b>");
try {
Object enUsData = getLocaleDataInstance(Locale.US);
Object localeData = getLocaleDataInstance(locale);
String[] previous;
result.append("<p>");
describeStringArray(result, "amPm", enUsData, localeData, null);
describeStringArray(result, "eras", enUsData, localeData, null);
result.append("<p>");
previous = describeStringArray(result, "longMonthNames", enUsData, localeData, null);
describeStringArray(result, "longStandAloneMonthNames", enUsData, localeData, previous);
previous = describeStringArray(result, "shortMonthNames", enUsData, localeData, null);
describeStringArray(result, "shortStandAloneMonthNames", enUsData, localeData, previous);
previous = describeStringArray(result, "tinyMonthNames", enUsData, localeData, null);
describeStringArray(result, "tinyStandAloneMonthNames", enUsData, localeData, previous);
result.append("<p>");
previous = describeStringArray(result, "longWeekdayNames", enUsData, localeData, null);
describeStringArray(result, "longStandAloneWeekdayNames", enUsData, localeData, previous);
previous = describeStringArray(result, "shortWeekdayNames", enUsData, localeData, null);
describeStringArray(result, "shortStandAloneWeekdayNames", enUsData, localeData, previous);
previous = describeStringArray(result, "tinyWeekdayNames", enUsData, localeData, null);
describeStringArray(result, "tinyStandAloneWeekdayNames", enUsData, localeData, previous);
result.append("<p>");
describeString(result, "yesterday", enUsData, localeData);
describeString(result, "today", enUsData, localeData);
describeString(result, "tomorrow", enUsData, localeData);
result.append("<p>");
describeString(result, "timeFormat12", enUsData, localeData);
describeString(result, "timeFormat24", enUsData, localeData);
result.append("<p>");
describeChar(result, "zeroDigit", enUsData, localeData);
describeChar(result, "decimalSeparator", enUsData, localeData);
describeChar(result, "groupingSeparator", enUsData, localeData);
describeChar(result, "patternSeparator", enUsData, localeData);
describeChar(result, "percent", enUsData, localeData);
describeChar(result, "perMill", enUsData, localeData);
describeChar(result, "monetarySeparator", enUsData, localeData);
describeChar(result, "minusSign", enUsData, localeData);
describeString(result, "exponentSeparator", enUsData, localeData);
describeString(result, "infinity", enUsData, localeData);
describeString(result, "NaN", enUsData, localeData);
} catch (Exception ex) {
result.append("(" + ex.getClass().getSimpleName() + " thrown: " + ex.getMessage() + ")");
System.err.println(ex);
}
}
return result.toString();
}
