serial:

serial:

serial:

serial:

serial:

serial:

• zoneStrings[i][0] - time zone ID
• zoneStrings[i][1] - long name of zone in standard time
• zoneStrings[i][2] - short name of zone in standard time
• zoneStrings[i][3] - long name of zone in daylight saving time
• zoneStrings[i][4] - short name of zone in daylight saving time

Also see:

java.util.TimeZone
serial:

serial:

since: 1.6 -

serial:

 public DateFormatSymbols() 
{
        initializeData(Locale.getDefault(Locale.Category.FORMAT));
}

Construct a DateFormatSymbols object by loading format data from resources for the default locale. This constructor can only construct instances for the locales supported by the Java runtime environment, not for those supported by installed DateFormatSymbolsProvider implementations. For full locale coverage, use the getInstance method.

Throws:

java.util.MissingResourceException - if the resources for the default locale cannot be found or cannot be loaded.

Also see:

getInstance()
exception: java.util.MissingResourceException - if the resources for the default locale cannot be found or cannot be loaded.

 public DateFormatSymbols(Locale locale) 
{
        initializeData(locale);
}

Construct a DateFormatSymbols object by loading format data from resources for the given locale. This constructor can only construct instances for the locales supported by the Java runtime environment, not for those supported by installed DateFormatSymbolsProvider implementations. For full locale coverage, use the getInstance method.

Throws:

java.util.MissingResourceException - if the resources for the specified locale cannot be found or cannot be loaded.

Also see:

getInstance(Locale)
exception: java.util.MissingResourceException - if the resources for the specified locale cannot be found or cannot be loaded.

 public Object clone() 
{
        try
        {
            DateFormatSymbols other = (DateFormatSymbols)super.clone();
            copyMembers(this, other);
            return other;
        } catch (CloneNotSupportedException e) {
            throw new InternalError();
        }
}

Overrides Cloneable

 public boolean equals(Object obj) 
{
        if (this == obj) return true;
        if (obj == null || getClass() != obj.getClass()) return false;
        DateFormatSymbols that = (DateFormatSymbols) obj;
        return (Arrays.equals(eras, that.eras)
                && Arrays.equals(months, that.months)
                && Arrays.equals(shortMonths, that.shortMonths)
                && Arrays.equals(weekdays, that.weekdays)
                && Arrays.equals(shortWeekdays, that.shortWeekdays)
                && Arrays.equals(ampms, that.ampms)
                && Arrays.deepEquals(getZoneStringsWrapper(), that.getZoneStringsWrapper())
                && ((localPatternChars != null
                  && localPatternChars.equals(that.localPatternChars))
                 || (localPatternChars == null
                  && that.localPatternChars == null)));
}

Override equals

 public String[] getAmPmStrings() 
{
        return Arrays.copyOf(ampms, ampms.length);
}

Gets ampm strings. For example: "AM" and "PM".

 public static Locale[] getAvailableLocales() 
{
        LocaleServiceProviderPool pool=
            LocaleServiceProviderPool.getPool(DateFormatSymbolsProvider.class);
        return pool.getAvailableLocales();
}

Returns an array of all locales for which the getInstance methods of this class can return localized instances. The returned array represents the union of locales supported by the Java runtime and by installed DateFormatSymbolsProvider implementations. It must contain at least a Locale instance equal to Locale.US .

 public String[] getEras() 
{
        return Arrays.copyOf(eras, eras.length);
}

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

 public static final DateFormatSymbols getInstance() 
{
        return getInstance(Locale.getDefault(Locale.Category.FORMAT));
}

Gets the DateFormatSymbols instance for the default locale. This method provides access to DateFormatSymbols instances for locales supported by the Java runtime itself as well as for those supported by installed DateFormatSymbolsProvider implementations.

 public static final DateFormatSymbols getInstance(Locale locale) 
{
        DateFormatSymbols dfs = getProviderInstance(locale);
        if (dfs != null) {
            return dfs;
        }
        return (DateFormatSymbols) getCachedInstance(locale).clone();
}

Gets the DateFormatSymbols instance for the specified locale. This method provides access to DateFormatSymbols instances for locales supported by the Java runtime itself as well as for those supported by installed DateFormatSymbolsProvider implementations.

 static final DateFormatSymbols getInstanceRef(Locale locale) 
{
        DateFormatSymbols dfs = getProviderInstance(locale);
        if (dfs != null) {
            return dfs;
        }
        return getCachedInstance(locale);
}

Returns a DateFormatSymbols provided by a provider or found in the cache. Note that this method returns a cached instance, not its clone. Therefore, the instance should never be given to an application.

 public String getLocalPatternChars() 
{
        return localPatternChars;
}

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

 public String[] getMonths() 
{
        return Arrays.copyOf(months, months.length);
}

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

 public String[] getShortMonths() 
{
        return Arrays.copyOf(shortMonths, shortMonths.length);
}

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

 public String[] getShortWeekdays() 
{
        return Arrays.copyOf(shortWeekdays, shortWeekdays.length);
}

Gets short weekday strings. For example: "Sun", "Mon", etc.

 public String[] getWeekdays() 
{
        return Arrays.copyOf(weekdays, weekdays.length);
}

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

 final int getZoneIndex(String ID) 
{
        String[][] zoneStrings = getZoneStringsWrapper();
        for (int index=0; index< zoneStrings.length; index++)
        {
            if (ID.equals(zoneStrings[index][0])) return index;
        }
        return -1;
}

Package private: used by SimpleDateFormat Gets the index for the given time zone ID to obtain the time zone strings for formatting. The time zone ID is just for programmatic lookup. NOT LOCALIZED!!!

 public String[][] getZoneStrings() 
{
        return getZoneStringsImpl(true);
}

Gets time zone strings. Use of this method is discouraged; use TimeZone.getDisplayName() instead.

The value returned is a two-dimensional array of strings of size n by m, where m is at least 5. Each of the n rows is an entry containing the localized names for a single TimeZone. Each such row contains (with i ranging from 0..n-1):

• zoneStrings[i][0] - time zone ID
• zoneStrings[i][1] - long name of zone in standard time
• zoneStrings[i][2] - short name of zone in standard time
• zoneStrings[i][3] - long name of zone in daylight saving time
• zoneStrings[i][4] - short name of zone in daylight saving time
The zone ID is not localized; it's one of the valid IDs of the TimeZone class that are not custom IDs. All other entries are localized names. If a zone does not implement daylight saving time, the daylight saving time names should not be used.

If setZoneStrings has been called on this DateFormatSymbols instance, then the strings provided by that call are returned. Otherwise, the returned array contains names provided by the Java runtime and by installed TimeZoneNameProvider implementations.

 final String[][] getZoneStringsWrapper() 
{
        if (isSubclassObject()) {
            return getZoneStrings();
        } else {
            return getZoneStringsImpl(false);
        }
}

Wrapper method to the getZoneStrings(), which is called from inside the java.text package and not to mutate the returned arrays, so that it does not need to create a defensive copy.

 public int hashCode() 
{
        int hashcode = 0;
        String[][] zoneStrings = getZoneStringsWrapper();
        for (int index = 0; index <  zoneStrings[0].length; ++index)
            hashcode ^= zoneStrings[0][index].hashCode();
        return hashcode;
}

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

 public  void setAmPmStrings(String[] newAmpms) 
{
        ampms = Arrays.copyOf(newAmpms, newAmpms.length);
}

Sets ampm strings. For example: "AM" and "PM".

 public  void setEras(String[] newEras) 
{
        eras = Arrays.copyOf(newEras, newEras.length);
}

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

 public  void setLocalPatternChars(String newLocalPatternChars) 
{
        // Call toString() to throw an NPE in case the argument is null
        localPatternChars = newLocalPatternChars.toString();
}

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

 public  void setMonths(String[] newMonths) 
{
        months = Arrays.copyOf(newMonths, newMonths.length);
}

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

 public  void setShortMonths(String[] newShortMonths) 
{
        shortMonths = Arrays.copyOf(newShortMonths, newShortMonths.length);
}

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

 public  void setShortWeekdays(String[] newShortWeekdays) 
{
        shortWeekdays = Arrays.copyOf(newShortWeekdays, newShortWeekdays.length);
}

Sets short weekday strings. For example: "Sun", "Mon", etc.

 public  void setWeekdays(String[] newWeekdays) 
{
        weekdays = Arrays.copyOf(newWeekdays, newWeekdays.length);
}

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

 public  void setZoneStrings(String[][] newZoneStrings) 
{
        String[][] aCopy = new String[newZoneStrings.length][];
        for (int i = 0; i <  newZoneStrings.length; ++i) {
            int len = newZoneStrings[i].length;
            if (len <  5) {
                throw new IllegalArgumentException();
            }
            aCopy[i] = Arrays.copyOf(newZoneStrings[i], len);
        }
        zoneStrings = aCopy;
        isZoneStringsSet = true;
}

Sets time zone strings. The argument must be a two-dimensional array of strings of size n by m, where m is at least 5. Each of the n rows is an entry containing the localized names for a single TimeZone. Each such row contains (with i ranging from 0..n-1):
• zoneStrings[i][0] - time zone ID
• zoneStrings[i][1] - long name of zone in standard time
• zoneStrings[i][2] - short name of zone in standard time
• zoneStrings[i][3] - long name of zone in daylight saving time
• zoneStrings[i][4] - short name of zone in daylight saving time
The zone ID is not localized; it's one of the valid IDs of the TimeZone class that are not custom IDs. All other entries are localized names.