#include <dtfmtsym.h>
Public Members | |||
![]() | ![]() | DateFormatSymbols (UErrorCode& status) | |
![]() | ![]() | Construct a DateFormatSymbols object by loading format data from resources for the default locale. More... | |
![]() | ![]() | DateFormatSymbols (const Locale& locale, UErrorCode& status) | |
![]() | ![]() | Construct a DateFormatSymbols object by loading format data from resources for the given locale. More... | |
![]() | ![]() | DateFormatSymbols (const DateFormatSymbols&) | |
![]() | ![]() | Copy constructor. More... | |
![]() | ![]() | DateFormatSymbols& | operator= (const DateFormatSymbols&) |
![]() | ![]() | Assignment operator. More... | |
![]() | ![]() | ~DateFormatSymbols () | |
![]() | ![]() | Destructor. More... | |
![]() | ![]() | UBool | operator== (const DateFormatSymbols& other) const |
![]() | ![]() | Return true if another object is semantically equal to this one. More... | |
![]() | ![]() | UBool | operator!= (const DateFormatSymbols& other) const |
![]() | ![]() | Return true if another object is semantically unequal to this one. More... | |
![]() | ![]() | const UnicodeString* | getEras (int32_t& count) const |
![]() | ![]() | Gets era strings. More... | |
![]() | ![]() | void | setEras (const UnicodeString* eras, int32_t count) |
![]() | ![]() | Sets era strings. More... | |
![]() | ![]() | const UnicodeString* | getMonths (int32_t& count) const |
![]() | ![]() | Gets month strings. More... | |
![]() | ![]() | void | setMonths (const UnicodeString* months, int32_t count) |
![]() | ![]() | Sets month strings. More... | |
![]() | ![]() | const UnicodeString* | getShortMonths (int32_t& count) const |
![]() | ![]() | Gets short month strings. More... | |
![]() | ![]() | void | setShortMonths (const UnicodeString* shortMonths, int32_t count) |
![]() | ![]() | Sets short month strings. More... | |
![]() | ![]() | const UnicodeString* | getWeekdays (int32_t& count) const |
![]() | ![]() | Gets weekday strings. More... | |
![]() | ![]() | void | setWeekdays (const UnicodeString* weekdays, int32_t count) |
![]() | ![]() | Sets weekday strings. More... | |
![]() | ![]() | const UnicodeString* | getShortWeekdays (int32_t& count) const |
![]() | ![]() | Gets short weekday strings. More... | |
![]() | ![]() | void | setShortWeekdays (const UnicodeString* shortWeekdays, int32_t count) |
![]() | ![]() | Sets short weekday strings. More... | |
![]() | ![]() | const UnicodeString* | getAmPmStrings (int32_t& count) const |
![]() | ![]() | Gets AM/PM strings. More... | |
![]() | ![]() | void | setAmPmStrings (const UnicodeString* ampms, int32_t count) |
![]() | ![]() | Sets ampm strings. More... | |
![]() | ![]() | const UnicodeString** | getZoneStrings (int32_t& rowCount, int32_t& columnCount) const |
![]() | ![]() | Gets timezone strings. More... | |
![]() | ![]() | void | setZoneStrings (const UnicodeString* const* strings, int32_t rowCount, int32_t columnCount) |
![]() | ![]() | Sets timezone strings. More... | |
![]() | ![]() | UnicodeString& | getLocalPatternChars (UnicodeString& result) const |
![]() | ![]() | Gets localized date-time pattern characters. More... | |
![]() | ![]() | void | setLocalPatternChars (const UnicodeString& newLocalPatternChars) |
![]() | ![]() | Sets localized date-time pattern characters. More... | |
Static Public Members | |||
![]() | ![]() | const UnicodeString& | getPatternChars (void) |
![]() | ![]() | Get the non-localized date-time pattern characters. More... | |
Friends | |||
![]() | ![]() | class | SimpleDateFormat |
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.
Definition at line 58 of file dtfmtsym.h.
DateFormatSymbols::DateFormatSymbols (UErrorCode & status) |
Construct a DateFormatSymbols object by loading format data from resources for the default locale.
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.
status | Output param set to success of failure. Failure results if the resources for the default cannot be found or cannot be loaded |
DateFormatSymbols::DateFormatSymbols (const Locale & locale, UErrorCode & status) |
Construct a DateFormatSymbols object by loading format data from resources for the given locale.
locale | Locale to load format data from. |
status | Output param set to success of failure. Failure results if the resources for the locale cannot be found or cannot be loaded |
DateFormatSymbols::DateFormatSymbols (const DateFormatSymbols &) |
Copy constructor.
DateFormatSymbols & DateFormatSymbols::operator= (const DateFormatSymbols &) |
Assignment operator.
DateFormatSymbols::~DateFormatSymbols () |
Destructor.
This is nonvirtual because this class is not designed to be subclassed.
UBool DateFormatSymbols::operator== (const DateFormatSymbols & other) const |
Return true if another object is semantically equal to this one.
UBool DateFormatSymbols::operator!= (const DateFormatSymbols & other) const [inline]
|
Return true if another object is semantically unequal to this one.
Definition at line 117 of file dtfmtsym.h.
const UnicodeString * DateFormatSymbols::getEras (int32_t & count) const |
Gets era strings.
For example: "AD" and "BC".
void DateFormatSymbols::setEras (const UnicodeString * eras, int32_t count) |
Sets era strings.
For example: "AD" and "BC".
eras | Array of era strings (DateFormatSymbols retains ownership.) |
count | Filled in with length of the array. |
const UnicodeString * DateFormatSymbols::getMonths (int32_t & count) const |
Gets month strings.
For example: "January", "February", etc.
count | Filled in with length of the array. |
void DateFormatSymbols::setMonths (const UnicodeString * months, int32_t count) |
Sets month strings.
For example: "January", "February", etc.
newMonths | the new month strings. (not adopted; caller retains ownership) |
const UnicodeString * DateFormatSymbols::getShortMonths (int32_t & count) const |
Gets short month strings.
For example: "Jan", "Feb", etc.
void DateFormatSymbols::setShortMonths (const UnicodeString * shortMonths, int32_t count) |
Sets short month strings.
For example: "Jan", "Feb", etc.
newShortMonths | the new short month strings. (not adopted; caller retains ownership) |
const UnicodeString * DateFormatSymbols::getWeekdays (int32_t & count) const |
Gets weekday strings.
For example: "Sunday", "Monday", etc.
void DateFormatSymbols::setWeekdays (const UnicodeString * weekdays, int32_t count) |
Sets weekday strings.
For example: "Sunday", "Monday", etc.
newWeekdays | the new weekday strings. (not adopted; caller retains ownership) |
const UnicodeString * DateFormatSymbols::getShortWeekdays (int32_t & count) const |
Gets short weekday strings.
For example: "Sun", "Mon", etc.
void DateFormatSymbols::setShortWeekdays (const UnicodeString * shortWeekdays, int32_t count) |
Sets short weekday strings.
For example: "Sun", "Mon", etc.
newShortWeekdays | the new short weekday strings. (not adopted; caller retains ownership) |
const UnicodeString * DateFormatSymbols::getAmPmStrings (int32_t & count) const |
Gets AM/PM strings.
For example: "AM" and "PM".
void DateFormatSymbols::setAmPmStrings (const UnicodeString * ampms, int32_t count) |
Sets ampm strings.
For example: "AM" and "PM".
newAmpms | the new ampm strings. (not adopted; caller retains ownership) |
const UnicodeString ** DateFormatSymbols::getZoneStrings (int32_t & rowCount, int32_t & columnCount) const |
Gets timezone strings.
These strings are stored in a 2-dimensional array.
rowCount | Output param to receive number of rows. |
columnCount | Output param to receive number of columns. |
void DateFormatSymbols::setZoneStrings (const UnicodeString *const * strings, int32_t rowCount, int32_t columnCount) |
Sets timezone strings.
These strings are stored in a 2-dimensional array.
strings | The timezone strings as a 2-d array to be copied. (not adopted; caller retains ownership) |
rowCount | The number of rows (count of first index). |
columnCount | The number of columns (count of second index). |
UnicodeString & DateFormatSymbols::getLocalPatternChars (UnicodeString & result) const |
Gets localized date-time pattern characters.
For example: 'u', 't', etc.
void DateFormatSymbols::setLocalPatternChars (const UnicodeString & newLocalPatternChars) |
Sets localized date-time pattern characters.
For example: 'u', 't', etc.
newLocalPatternChars | the new localized date-time pattern characters. |
const UnicodeString & DateFormatSymbols::getPatternChars (void) [inline, static]
|
Get the non-localized date-time pattern characters.
Definition at line 227 of file dtfmtsym.h.
friend class SimpleDateFormat [friend]
|
Definition at line 245 of file dtfmtsym.h.