Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/classicu_1_1DateFormatSymbols.html below:

ICU 77.1: icu::DateFormatSymbols Class Reference

DateFormatSymbols is a public class for encapsulating localizable date-time formatting data – including timezone data. More...

#include <dtfmtsym.h>

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.

DateFormatSymbols are not expected to be subclassed. Data for a calendar is loaded out of resource bundles. The 'type' parameter indicates the type of calendar, for example, "gregorian" or "japanese". If the type is not gregorian (or nullptr, or an empty string) then the type is appended to the resource name, for example, 'Eras_japanese' instead of 'Eras'. If the resource 'Eras_japanese' did not exist (even in root), then this class will fall back to just 'Eras', that is, Gregorian data. Therefore, the calendar implementor MUST ensure that the root locale at least contains any resources that are to be particularized for the calendar type.

Definition at line 85 of file dtfmtsym.h.

Selector for date formatting context.

Stable:

ICU 3.6

One more than the highest normal DtContextType value.

Deprecated:

ICU 58 The numeric value may change over time, see ICU ticket #12420.

Definition at line 278 of file dtfmtsym.h.

Selector for date formatting width.

Stable:

ICU 3.6

Short width is currently only supported for weekday names.

Stable:

ICU 51

One more than the highest normal DtWidthType value.

Deprecated:

ICU 58 The numeric value may change over time, see ICU ticket #12420.

Definition at line 294 of file dtfmtsym.h.

Constants for capitalization context usage types.

Internal:

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

Definition at line 606 of file dtfmtsym.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 line 514 of file dtfmtsym.h.

Construct a DateFormatSymbols 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 a DateFormatSymbols 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 a DateFormatSymbols 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 by Calendar::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 a DateFormatSymbols 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 by Calendar::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.

Destructor.

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

Stable:

ICU 2.0

Gets a DateFormatSymbols 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 new DateFormatSymbols 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 weekday strings. (DateFormatSymbols retains ownership.)

Stable:

ICU 2.0

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

Stable:

ICU 2.2

Reimplemented from icu::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

Returns

true if other is semantically unequal to this.

Stable:

ICU 2.0

Definition at line 187 of file dtfmtsym.h.

References icu::operator==().

Assignment operator.

Stable:

ICU 2.0

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

Parameters

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 Filled in with length of the array.

Stable:

ICU 2.0

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 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 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 a DateFormatSymbols. Therefore, the time zone strings set by this method have no effects in an instance of SimpleDateFormat 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 line 437 of file dtfmtsym.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 line 431 of file dtfmtsym.h.

The documentation for this class was generated from the following file:

• i18n/unicode/dtfmtsym.h

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4