Movatterモバイル変換

Selector for date formatting context.

Stable:

ICU 3.6

Definition at line274 of filedtfmtsym.h.

Selector for date formatting width.

Stable:

ICU 3.6

Definition at line290 of filedtfmtsym.h.

Constants for capitalization context usage types.

Internal:

Do not use. This API is for internal use only.

Definition at line651 of filedtfmtsym.h.

Somewhat temporary constants for leap month pattern types, adequate for supporting just leap month patterns as needed for Chinese lunar calendar.

Eventually we will add full support for different month pattern types (needed for other calendars such as Hindu) at which point this approach will be replaced by a more complete approach.

Internal:

Do not use. This API is for internal use only.

Definition at line557 of filedtfmtsym.h.

Construct aDateFormatSymbols object by loading format data from resources for the default locale, in the default calendar (Gregorian).

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.

Parameters

status

Status code. Failure results if the resources for the default cannot be found or cannot be loaded

Stable:

ICU 2.0

Construct aDateFormatSymbols object by loading format data from resources for the given locale, in the default calendar (Gregorian).

Parameters

locale	Locale to load format data from.
status	Status code. Failure results if the resources for the locale cannot be found or cannot be loaded

Stable:

ICU 2.0

Construct aDateFormatSymbols object by loading format data from resources for the default locale, in the default calendar (Gregorian).

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.

Parameters

type	Type of calendar (as returned byCalendar::getType). Will be used to access the correct set of strings. (nullptr or empty string defaults to "gregorian".)
status	Status code. Failure results if the resources for the default cannot be found or cannot be loaded

Internal:

Do not use. This API is for internal use only.

Construct aDateFormatSymbols object by loading format data from resources for the given locale, in the default calendar (Gregorian).

Parameters

locale	Locale to load format data from.
type	Type of calendar (as returned byCalendar::getType). Will be used to access the correct set of strings. (nullptr or empty string defaults to "gregorian".)
status	Status code. Failure results if the resources for the locale cannot be found or cannot be loaded

Internal:

Do not use. This API is for internal use only.

Copy constructor.

Stable:

ICU 2.0

Destructor.

This is nonvirtual because this class is not designed to be subclassed.

Stable:

ICU 2.0

Gets aDateFormatSymbols by locale.

Unlike the constructors which always use gregorian calendar, this method uses the calendar in the locale. If the locale contains no explicit calendar, this method uses the default calendar for that locale.

Parameters

locale	the locale.
status	error returned here.

Returns

the newDateFormatSymbols which the caller owns.

Internal:

Do not use. This API is for internal use only. For ICU use only.

Gets AM/PM strings.

For example: "AM" and "PM".

Parameters

count

Filled in with length of the array.

Returns

The AM/PM strings. (DateFormatSymbols retains ownership.)

Stable:

ICU 2.0

Gets AM/PM strings with the specified width.

For example: "A" and "P".

Parameters

count	Filled in with length of the array.
context	The usage context. Currently ignored; FORMAT names always returned.
width	The width of returned strings, either WIDE, ABBREVIATED, or NARROW.

Returns

The AM/PM strings. (DateFormatSymbols retains ownership.)

Draft:

This API may be changed in the future versions and was introduced in ICU 78

ICU "poor man's RTTI", returns a UClassID for the actual class.

Stable:

ICU 2.2

Reimplemented fromicu::UObject.

Gets era name strings.

For example: "Anno Domini" and "Before Christ".

Parameters

count

Filled in with length of the array.

Returns

the era name strings.

Stable:

ICU 3.4

Gets abbreviated era strings.

For example: "AD" and "BC".

Parameters

count

Filled in with length of the array.

Returns

the era strings.

Stable:

ICU 2.0

Somewhat temporary function for getting complete set of leap month patterns for all contexts & widths, indexed by EMonthPatternType values.

Returns nullptr if calendar does not have leap month patterns. Note, there is currently no setter for this. Eventually we will add full support for different month pattern types (needed for other calendars such as Hindu) at which point this approach will be replaced by a more complete approach.

Parameters

count

Filled in with length of the array (may be 0).

Returns

The leap month patterns (DateFormatSymbols retains ownership). May be nullptr if there are no leap month patterns for this calendar.

Internal:

Do not use. This API is for internal use only.

Returns the locale for this object.

Two flavors are available: valid and actual locale.

Stable:

ICU 2.8

Gets localized date-time pattern characters.

For example: 'u', 't', etc.

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.

Parameters

result

Output param which will receive the localized date-time pattern characters.

Returns

A reference to 'result'.

Stable:

ICU 2.0

Gets month strings.

For example: "January", "February", etc.

Parameters

count

Filled in with length of the array.

Returns

the month strings. (DateFormatSymbols retains ownership.)

Stable:

ICU 2.0

Gets month strings by width and context.

For example: "January", "February", etc.

Parameters

count	Filled in with length of the array.
context	The formatting context, either FORMAT or STANDALONE
width	The width of returned strings, either WIDE, ABBREVIATED, or NARROW.

Returns

the month strings. (DateFormatSymbols retains ownership.)

Stable:

ICU 3.4

Gets narrow era strings.

For example: "A" and "B".

Parameters

count

Filled in with length of the array.

Returns

the narrow era strings.

Stable:

ICU 4.2

Get the non-localized date-time pattern characters.

Returns

the non-localized date-time pattern characters

Stable:

ICU 2.0

Gets quarter strings by width and context.

For example: "1st Quarter", "2nd Quarter", etc.

Parameters

count	Filled in with length of the array.
context	The formatting context, either FORMAT or STANDALONE
width	The width of returned strings, either WIDE, ABBREVIATED, or NARROW.

Returns

the quarter strings. (DateFormatSymbols retains ownership.)

Stable:

ICU 3.6

Gets short month strings.

For example: "Jan", "Feb", etc.

Parameters

count

Filled in with length of the array.

Returns

the short month strings. (DateFormatSymbols retains ownership.)

Stable:

ICU 2.0

Gets abbreviated weekday strings.

For example: "Sun", "Mon", etc. (Note: The method name is misleading; it does not get the CLDR-style "short" weekday strings, e.g. "Su", "Mo", etc.)

Parameters

count

Filled in with length of the array.

Returns

the abbreviated weekday strings. (DateFormatSymbols retains ownership.)

Stable:

ICU 2.0

ICU "poor man's RTTI", returns a UClassID for this class.

Stable:

ICU 2.2

Gets the time separator string.

For example: ":".

Parameters

result

Output param which will receive the time separator string.

Returns

A reference to 'result'.

Internal:

Do not use. This API is for internal use only.

Gets wide weekday strings.

For example: "Sunday", "Monday", etc.

Parameters

count

Filled in with length of the array.

Returns

the weekday strings. (DateFormatSymbols retains ownership.)

Stable:

ICU 2.0

Gets weekday strings by width and context.

For example: "Sunday", "Monday", etc.

Parameters

count	Filled in with length of the array.
context	The formatting context, either FORMAT or STANDALONE
width	The width of returned strings, either WIDE, ABBREVIATED, SHORT, or NARROW

Returns

the month strings. (DateFormatSymbols retains ownership.)

Stable:

ICU 3.4

Gets cyclic year name strings if the calendar has them, by width and context.

For example: "jia-zi", "yi-chou", etc.

Parameters

count	Filled in with length of the array.
context	The usage context: FORMAT, STANDALONE.
width	The requested name width: WIDE, ABBREVIATED, NARROW.

Returns

The year name strings (DateFormatSymbols retains ownership), or null if they are not available for this calendar.

Stable:

ICU 54

Gets calendar zodiac name strings if the calendar has them, by width and context.

For example: "Rat", "Ox", "Tiger", etc.

Parameters

count	Filled in with length of the array.
context	The usage context: FORMAT, STANDALONE.
width	The requested name width: WIDE, ABBREVIATED, NARROW.

Returns

The zodiac name strings (DateFormatSymbols retains ownership), or null if they are not available for this calendar.

Stable:

ICU 54

Gets timezone strings.

These strings are stored in a 2-dimensional array.

Parameters

rowCount	Output param to receive number of rows.
columnCount	Output param to receive number of columns.

Returns

The timezone strings as a 2-d array. (DateFormatSymbols retains ownership.)

Deprecated:

ICU 3.6

Return true if another object is semantically unequal to this one.

Parameters

other

theDateFormatSymbols object to be compared with.

Returns

true if other is semantically unequal to this.

Stable:

ICU 2.0

Definition at line183 of filedtfmtsym.h.

Referencesicu::operator==().

Assignment operator.

Stable:

ICU 2.0

Return true if another object is semantically equal to this one.

Parameters

other

theDateFormatSymbols object to be compared with.

Returns

true if other is semantically equal to this.

Stable:

ICU 2.0

Sets ampm strings.

For example: "AM" and "PM".

Parameters

ampms	The new ampm strings. (not adopted; caller retains ownership)
count	The number of strings in the array.

Stable:

ICU 2.0

Sets AM/PM strings with the specified width.

For example: "A" and "P".

Parameters

ampms	The new AM/PM strings. (not adopted; caller retains ownership)
count	The number of strings in the array.
context	The usage context. Currently ignored; always sets FORMAT names.
width	The width of set strings, either WIDE, ABBREVIATED, or NARROW.

Draft:

This API may be changed in the future versions and was introduced in ICU 78

Sets era name strings.

For example: "Anno Domini" and "Before Christ".

Parameters

eraNames	Array of era name strings (DateFormatSymbols retains ownership.)
count	Filled in with length of the array.

Stable:

ICU 3.6

Sets abbreviated era strings.

For example: "AD" and "BC".

Parameters

eras	Array of era strings (DateFormatSymbols retains ownership.)
count	Filled in with length of the array.

Stable:

ICU 2.0

Sets localized date-time pattern characters.

For example: 'u', 't', etc.

Parameters

newLocalPatternChars

the new localized date-time pattern characters.

Stable:

ICU 2.0

Sets month strings.

For example: "January", "February", etc.

Parameters

months	the new month strings. (not adopted; caller retains ownership)
count	Filled in with length of the array.

Stable:

ICU 2.0

Sets month strings by width and context.

For example: "January", "February", etc.

Parameters

months	The new month strings. (not adopted; caller retains ownership)
count	Filled in with length of the array.
context	The formatting context, either FORMAT or STANDALONE
width	The width of returned strings, either WIDE, ABBREVIATED, or NARROW.

Stable:

ICU 3.6

Sets narrow era strings.

For example: "A" and "B".

Parameters

narrowEras	Array of narrow era strings (DateFormatSymbols retains ownership.)
count	Filled in with length of the array.

Stable:

ICU 4.2

Sets quarter strings by width and context.

For example: "1st Quarter", "2nd Quarter", etc.

Parameters

quarters	The new quarter strings. (not adopted; caller retains ownership)
count	The number of strings in the array.
context	The formatting context, either FORMAT or STANDALONE
width	The width of set strings, either WIDE, ABBREVIATED, or NARROW.

Stable:

ICU 3.6

Sets short month strings.

For example: "Jan", "Feb", etc.

Parameters

count	Filled in with length of the array.
shortMonths	the new short month strings. (not adopted; caller retains ownership)

Stable:

ICU 2.0

Sets abbreviated weekday strings.

For example: "Sun", "Mon", etc. (Note: The method name is misleading; it does not set the CLDR-style "short" weekday strings, e.g. "Su", "Mo", etc.)

Parameters

abbrevWeekdays	the new abbreviated weekday strings. (not adopted; caller retains ownership)
count	Filled in with length of the array.

Stable:

ICU 2.0

Sets the time separator string.

For example: ":".

Parameters

newTimeSeparator

the new time separator string.

Internal:

Do not use. This API is for internal use only.

Sets wide weekday strings.

For example: "Sunday", "Monday", etc.

Parameters

weekdays	the new weekday strings. (not adopted; caller retains ownership)
count	Filled in with length of the array.

Stable:

ICU 2.0

Sets weekday strings by width and context.

For example: "Sunday", "Monday", etc.

Parameters

weekdays	The new weekday strings. (not adopted; caller retains ownership)
count	Filled in with length of the array.
context	The formatting context, either FORMAT or STANDALONE
width	The width of returned strings, either WIDE, ABBREVIATED, SHORT, or NARROW

Stable:

ICU 3.6

Sets cyclic year name strings by width and context.

For example: "jia-zi", "yi-chou", etc.

Parameters

yearNames	The new cyclic year name strings (not adopted; caller retains ownership).
count	The length of the array.
context	The usage context: FORMAT, STANDALONE (currently only FORMAT is supported).
width	The name width: WIDE, ABBREVIATED, NARROW (currently only ABBREVIATED is supported).

Stable:

ICU 54

Sets calendar zodiac name strings by width and context.

For example: "Rat", "Ox", "Tiger", etc.

Parameters

zodiacNames	The new zodiac name strings (not adopted; caller retains ownership).
count	The length of the array.
context	The usage context: FORMAT, STANDALONE (currently only FORMAT is supported).
width	The name width: WIDE, ABBREVIATED, NARROW (currently only ABBREVIATED is supported).

Stable:

ICU 54

Sets timezone strings.

These strings are stored in a 2-dimensional array.

Note:SimpleDateFormat no longer use the zone strings stored in aDateFormatSymbols. Therefore, the time zone strings set by this method have no effects in an instance ofSimpleDateFormat for formatting time zones.

Parameters

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).

Stable:

ICU 2.0

This alternate time separator is always recognized when parsing.

Internal:

Do not use. This API is for internal use only.

Definition at line474 of filedtfmtsym.h.

This default time separator is used for formatting when the locale doesn't specify any time separator, and always recognized when parsing.

Internal:

Do not use. This API is for internal use only.

Definition at line468 of filedtfmtsym.h.