DateFormatSymbols is a public class for encapsulating localizable date-time formatting data -- including timezone data
DateFormatSymbols is a public class for encapsulating localizable date-time formatting data -- including timezone data. DateFormatSymbols is used by DateFormat and SimpleDateFormat.Rather than first creating a DateFormatSymbols to get a date-time formatter by using a SimpleDateFormat constructor, clients are encouraged to create a date-time formatter using the getTimeInstance(), getDateInstance(), or getDateTimeInstance() method in DateFormat. Each of these methods can return a date/time formatter initialized with a default format pattern along with the date-time formatting data for a given or default locale. After a formatter is created, clients may modify the format pattern using the setPattern function as so desired. For more information on using these formatter factory functions, see DateFormat.
If clients decide to create a date-time formatter with a particular format pattern and locale, they can do so with new SimpleDateFormat(aPattern, new DateFormatSymbols(aLocale)). This will load the appropriate date-time formatting data from the locale.
DateFormatSymbols objects are clonable. When clients obtain a DateFormatSymbols object, they can feel free to modify the date-time formatting data as necessary. For instance, clients can replace the localized date-time format pattern characters with the ones that they feel easy to remember. Or they can change the representative cities originally picked by default to using their favorite ones.
New DateFormatSymbols sub-classes may be added to support SimpleDateFormat for date-time formatting for additional locales.
NOTE: This constructor will never fail; if it cannot get resource data for the default locale, it will return a last-resort object based on hard-coded strings.
DateFormatSymbols(const Locale& locale, UErrorCode& status)
status - Output param set to success of failure. Failure
results if the resources for the locale cannot be
found or cannot be loaded DateFormatSymbols(const DateFormatSymbols&)
DateFormatSymbols& operator=(const DateFormatSymbols&)
~DateFormatSymbols()
bool_t operator==(const DateFormatSymbols& other) const
bool_t operator!=(const DateFormatSymbols& other) const
const UnicodeString* getEras(int32_t& count) const
void setEras(const UnicodeString* eras, int32_t count)
count - Filled in with length of the array. const UnicodeString* getMonths(int32_t& count) const
void setMonths(const UnicodeString* months, int32_t count)
const UnicodeString* getShortMonths(int32_t& count) const
void setShortMonths(const UnicodeString* shortMonths, int32_t count)
const UnicodeString* getWeekdays(int32_t& count) const
void setWeekdays(const UnicodeString* weekdays, int32_t count)
const UnicodeString* getShortWeekdays(int32_t& count) const
void setShortWeekdays(const UnicodeString* shortWeekdays, int32_t count)
const UnicodeString* getAmPmStrings(int32_t& count) const
void setAmPmStrings(const UnicodeString* ampms, int32_t count)
const UnicodeString** getZoneStrings(int32_t& rowCount, int32_t& columnCount) const
columnCount - Output param to receive number of columns.
void setZoneStrings(const UnicodeString* const* strings, int32_t rowCount, int32_t columnCount)
rowCount - The number of rows (count of first index).
columnCount - The number of columns (count of second index). static const UnicodeString& getPatternChars(void)
UnicodeString& getLocalPatternChars(UnicodeString& result) const
void setLocalPatternChars(const UnicodeString& newLocalPatternChars)
alphabetic index hierarchy of classes
this page has been generated automatically by doc++
(c)opyright by Malte Zöckler, Roland Wunderling
contact: doc++@zib.de