| Index: icu46/source/i18n/unicode/dtfmtsym.h
|
| ===================================================================
|
| --- icu46/source/i18n/unicode/dtfmtsym.h (revision 0)
|
| +++ icu46/source/i18n/unicode/dtfmtsym.h (revision 0)
|
| @@ -0,0 +1,755 @@
|
| +/*
|
| +********************************************************************************
|
| +* Copyright (C) 1997-2010, International Business Machines
|
| +* Corporation and others. All Rights Reserved.
|
| +********************************************************************************
|
| +*
|
| +* File DTFMTSYM.H
|
| +*
|
| +* Modification History:
|
| +*
|
| +* Date Name Description
|
| +* 02/19/97 aliu Converted from java.
|
| +* 07/21/98 stephen Added getZoneIndex()
|
| +* Changed to match C++ conventions
|
| +********************************************************************************
|
| +*/
|
| +
|
| +#ifndef DTFMTSYM_H
|
| +#define DTFMTSYM_H
|
| +
|
| +#include "unicode/utypes.h"
|
| +
|
| +#if !UCONFIG_NO_FORMATTING
|
| +
|
| +#include "unicode/calendar.h"
|
| +#include "unicode/uobject.h"
|
| +#include "unicode/locid.h"
|
| +#include "unicode/ures.h"
|
| +
|
| +/**
|
| + * \file
|
| + * \brief C++ API: Symbols for formatting dates.
|
| + */
|
| +
|
| +U_NAMESPACE_BEGIN
|
| +
|
| +/* forward declaration */
|
| +class SimpleDateFormat;
|
| +class Hashtable;
|
| +class ZoneStringFormat;
|
| +class SafeZoneStringFormatPtr;
|
| +
|
| +/**
|
| + * DateFormatSymbols is a public class for encapsulating localizable date-time
|
| + * formatting data -- including timezone data. DateFormatSymbols is used by
|
| + * DateFormat and SimpleDateFormat.
|
| + * <P>
|
| + * 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.
|
| + * <P>
|
| + * 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.
|
| + * <P>
|
| + * 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.
|
| + * <P>
|
| + * 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 NULL, 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.
|
| + */
|
| +class U_I18N_API DateFormatSymbols : public UObject {
|
| +public:
|
| + /**
|
| + * Construct a DateFormatSymbols object by loading format data from
|
| + * resources for the default locale, in the default calendar (Gregorian).
|
| + * <P>
|
| + * 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.
|
| + *
|
| + * @param status Status code. Failure
|
| + * results if the resources for the default cannot be
|
| + * found or cannot be loaded
|
| + * @stable ICU 2.0
|
| + */
|
| + DateFormatSymbols(UErrorCode& status);
|
| +
|
| + /**
|
| + * Construct a DateFormatSymbols object by loading format data from
|
| + * resources for the given locale, in the default calendar (Gregorian).
|
| + *
|
| + * @param locale Locale to load format data from.
|
| + * @param status Status code. Failure
|
| + * results if the resources for the locale cannot be
|
| + * found or cannot be loaded
|
| + * @stable ICU 2.0
|
| + */
|
| + DateFormatSymbols(const Locale& locale,
|
| + UErrorCode& status);
|
| +
|
| + /**
|
| + * Construct a DateFormatSymbols object by loading format data from
|
| + * resources for the default locale, in the default calendar (Gregorian).
|
| + * <P>
|
| + * 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.
|
| + *
|
| + * @param type Type of calendar (as returned by Calendar::getType).
|
| + * Will be used to access the correct set of strings.
|
| + * (NULL or empty string defaults to "gregorian".)
|
| + * @param status Status code. Failure
|
| + * results if the resources for the default cannot be
|
| + * found or cannot be loaded
|
| + * @internal
|
| + */
|
| + DateFormatSymbols(const char *type, UErrorCode& status);
|
| +
|
| + /**
|
| + * Construct a DateFormatSymbols object by loading format data from
|
| + * resources for the given locale, in the default calendar (Gregorian).
|
| + *
|
| + * @param locale Locale to load format data from.
|
| + * @param type Type of calendar (as returned by Calendar::getType).
|
| + * Will be used to access the correct set of strings.
|
| + * (NULL or empty string defaults to "gregorian".)
|
| + * @param status Status code. Failure
|
| + * results if the resources for the locale cannot be
|
| + * found or cannot be loaded
|
| + * @internal
|
| + */
|
| + DateFormatSymbols(const Locale& locale,
|
| + const char *type,
|
| + UErrorCode& status);
|
| +
|
| + /**
|
| + * Copy constructor.
|
| + * @stable ICU 2.0
|
| + */
|
| + DateFormatSymbols(const DateFormatSymbols&);
|
| +
|
| + /**
|
| + * Assignment operator.
|
| + * @stable ICU 2.0
|
| + */
|
| + DateFormatSymbols& operator=(const DateFormatSymbols&);
|
| +
|
| + /**
|
| + * Destructor. This is nonvirtual because this class is not designed to be
|
| + * subclassed.
|
| + * @stable ICU 2.0
|
| + */
|
| + virtual ~DateFormatSymbols();
|
| +
|
| + /**
|
| + * Return true if another object is semantically equal to this one.
|
| + *
|
| + * @param other the DateFormatSymbols object to be compared with.
|
| + * @return true if other is semantically equal to this.
|
| + * @stable ICU 2.0
|
| + */
|
| + UBool operator==(const DateFormatSymbols& other) const;
|
| +
|
| + /**
|
| + * Return true if another object is semantically unequal to this one.
|
| + *
|
| + * @param other the DateFormatSymbols object to be compared with.
|
| + * @return true if other is semantically unequal to this.
|
| + * @stable ICU 2.0
|
| + */
|
| + UBool operator!=(const DateFormatSymbols& other) const { return !operator==(other); }
|
| +
|
| + /**
|
| + * Gets abbreviated era strings. For example: "AD" and "BC".
|
| + *
|
| + * @param count Filled in with length of the array.
|
| + * @return the era strings.
|
| + * @stable ICU 2.0
|
| + */
|
| + const UnicodeString* getEras(int32_t& count) const;
|
| +
|
| + /**
|
| + * Sets abbreviated era strings. For example: "AD" and "BC".
|
| + * @param eras Array of era strings (DateFormatSymbols retains ownership.)
|
| + * @param count Filled in with length of the array.
|
| + * @stable ICU 2.0
|
| + */
|
| + void setEras(const UnicodeString* eras, int32_t count);
|
| +
|
| + /**
|
| + * Gets era name strings. For example: "Anno Domini" and "Before Christ".
|
| + *
|
| + * @param count Filled in with length of the array.
|
| + * @return the era name strings.
|
| + * @stable ICU 3.4
|
| + */
|
| + const UnicodeString* getEraNames(int32_t& count) const;
|
| +
|
| + /**
|
| + * Sets era name strings. For example: "Anno Domini" and "Before Christ".
|
| + * @param eraNames Array of era name strings (DateFormatSymbols retains ownership.)
|
| + * @param count Filled in with length of the array.
|
| + * @stable ICU 3.6
|
| + */
|
| + void setEraNames(const UnicodeString* eraNames, int32_t count);
|
| +
|
| + /**
|
| + * Gets narrow era strings. For example: "A" and "B".
|
| + *
|
| + * @param count Filled in with length of the array.
|
| + * @return the narrow era strings.
|
| + * @stable ICU 4.2
|
| + */
|
| + const UnicodeString* getNarrowEras(int32_t& count) const;
|
| +
|
| + /**
|
| + * Sets narrow era strings. For example: "A" and "B".
|
| + * @param narrowEras Array of narrow era strings (DateFormatSymbols retains ownership.)
|
| + * @param count Filled in with length of the array.
|
| + * @stable ICU 4.2
|
| + */
|
| + void setNarrowEras(const UnicodeString* narrowEras, int32_t count);
|
| +
|
| + /**
|
| + * Gets month strings. For example: "January", "February", etc.
|
| + * @param count Filled in with length of the array.
|
| + * @return the month strings. (DateFormatSymbols retains ownership.)
|
| + * @stable ICU 2.0
|
| + */
|
| + const UnicodeString* getMonths(int32_t& count) const;
|
| +
|
| + /**
|
| + * Sets month strings. For example: "January", "February", etc.
|
| + *
|
| + * @param months the new month strings. (not adopted; caller retains ownership)
|
| + * @param count Filled in with length of the array.
|
| + * @stable ICU 2.0
|
| + */
|
| + void setMonths(const UnicodeString* months, int32_t count);
|
| +
|
| + /**
|
| + * Gets short month strings. For example: "Jan", "Feb", etc.
|
| + *
|
| + * @param count Filled in with length of the array.
|
| + * @return the short month strings. (DateFormatSymbols retains ownership.)
|
| + * @stable ICU 2.0
|
| + */
|
| + const UnicodeString* getShortMonths(int32_t& count) const;
|
| +
|
| + /**
|
| + * Sets short month strings. For example: "Jan", "Feb", etc.
|
| + * @param count Filled in with length of the array.
|
| + * @param shortMonths the new short month strings. (not adopted; caller retains ownership)
|
| + * @stable ICU 2.0
|
| + */
|
| + void setShortMonths(const UnicodeString* shortMonths, int32_t count);
|
| +
|
| + /**
|
| + * Selector for date formatting context
|
| + * @stable ICU 3.6
|
| + */
|
| + enum DtContextType {
|
| + FORMAT,
|
| + STANDALONE,
|
| + DT_CONTEXT_COUNT
|
| + };
|
| +
|
| + /**
|
| + * Selector for date formatting width
|
| + * @stable ICU 3.6
|
| + */
|
| + enum DtWidthType {
|
| + ABBREVIATED,
|
| + WIDE,
|
| + NARROW,
|
| + DT_WIDTH_COUNT
|
| + };
|
| +
|
| + /**
|
| + * Gets month strings by width and context. For example: "January", "February", etc.
|
| + * @param count Filled in with length of the array.
|
| + * @param context The formatting context, either FORMAT or STANDALONE
|
| + * @param width The width of returned strings, either WIDE, ABBREVIATED, or NARROW.
|
| + * @return the month strings. (DateFormatSymbols retains ownership.)
|
| + * @stable ICU 3.4
|
| + */
|
| + const UnicodeString* getMonths(int32_t& count, DtContextType context, DtWidthType width) const;
|
| +
|
| + /**
|
| + * Sets month strings by width and context. For example: "January", "February", etc.
|
| + *
|
| + * @param months The new month strings. (not adopted; caller retains ownership)
|
| + * @param count Filled in with length of the array.
|
| + * @param context The formatting context, either FORMAT or STANDALONE
|
| + * @param width The width of returned strings, either WIDE, ABBREVIATED, or NARROW.
|
| + * @stable ICU 3.6
|
| + */
|
| + void setMonths(const UnicodeString* months, int32_t count, DtContextType context, DtWidthType width);
|
| +
|
| + /**
|
| + * Gets weekday strings. For example: "Sunday", "Monday", etc.
|
| + * @param count Filled in with length of the array.
|
| + * @return the weekday strings. (DateFormatSymbols retains ownership.)
|
| + * @stable ICU 2.0
|
| + */
|
| + const UnicodeString* getWeekdays(int32_t& count) const;
|
| +
|
| +
|
| + /**
|
| + * Sets weekday strings. For example: "Sunday", "Monday", etc.
|
| + * @param weekdays the new weekday strings. (not adopted; caller retains ownership)
|
| + * @param count Filled in with length of the array.
|
| + * @stable ICU 2.0
|
| + */
|
| + void setWeekdays(const UnicodeString* weekdays, int32_t count);
|
| +
|
| + /**
|
| + * Gets short weekday strings. For example: "Sun", "Mon", etc.
|
| + * @param count Filled in with length of the array.
|
| + * @return the short weekday strings. (DateFormatSymbols retains ownership.)
|
| + * @stable ICU 2.0
|
| + */
|
| + const UnicodeString* getShortWeekdays(int32_t& count) const;
|
| +
|
| + /**
|
| + * Sets short weekday strings. For example: "Sun", "Mon", etc.
|
| + * @param shortWeekdays the new short weekday strings. (not adopted; caller retains ownership)
|
| + * @param count Filled in with length of the array.
|
| + * @stable ICU 2.0
|
| + */
|
| + void setShortWeekdays(const UnicodeString* shortWeekdays, int32_t count);
|
| +
|
| + /**
|
| + * Gets weekday strings by width and context. For example: "Sunday", "Monday", etc.
|
| + * @param count Filled in with length of the array.
|
| + * @param context The formatting context, either FORMAT or STANDALONE
|
| + * @param width The width of returned strings, either WIDE, ABBREVIATED, or NARROW
|
| + * @return the month strings. (DateFormatSymbols retains ownership.)
|
| + * @stable ICU 3.4
|
| + */
|
| + const UnicodeString* getWeekdays(int32_t& count, DtContextType context, DtWidthType width) const;
|
| +
|
| + /**
|
| + * Sets weekday strings by width and context. For example: "Sunday", "Monday", etc.
|
| + * @param weekdays The new weekday strings. (not adopted; caller retains ownership)
|
| + * @param count Filled in with length of the array.
|
| + * @param context The formatting context, either FORMAT or STANDALONE
|
| + * @param width The width of returned strings, either WIDE, ABBREVIATED, or NARROW
|
| + * @stable ICU 3.6
|
| + */
|
| + void setWeekdays(const UnicodeString* weekdays, int32_t count, DtContextType context, DtWidthType width);
|
| +
|
| + /**
|
| + * Gets quarter strings by width and context. For example: "1st Quarter", "2nd Quarter", etc.
|
| + * @param count Filled in with length of the array.
|
| + * @param context The formatting context, either FORMAT or STANDALONE
|
| + * @param width The width of returned strings, either WIDE or ABBREVIATED. There
|
| + * are no NARROW quarters.
|
| + * @return the quarter strings. (DateFormatSymbols retains ownership.)
|
| + * @stable ICU 3.6
|
| + */
|
| + const UnicodeString* getQuarters(int32_t& count, DtContextType context, DtWidthType width) const;
|
| +
|
| + /**
|
| + * Sets quarter strings by width and context. For example: "1st Quarter", "2nd Quarter", etc.
|
| + *
|
| + * @param quarters The new quarter strings. (not adopted; caller retains ownership)
|
| + * @param count Filled in with length of the array.
|
| + * @param context The formatting context, either FORMAT or STANDALONE
|
| + * @param width The width of returned strings, either WIDE or ABBREVIATED. There
|
| + * are no NARROW quarters.
|
| + * @stable ICU 3.6
|
| + */
|
| + void setQuarters(const UnicodeString* quarters, int32_t count, DtContextType context, DtWidthType width);
|
| +
|
| + /**
|
| + * Gets AM/PM strings. For example: "AM" and "PM".
|
| + * @param count Filled in with length of the array.
|
| + * @return the weekday strings. (DateFormatSymbols retains ownership.)
|
| + * @stable ICU 2.0
|
| + */
|
| + const UnicodeString* getAmPmStrings(int32_t& count) const;
|
| +
|
| + /**
|
| + * Sets ampm strings. For example: "AM" and "PM".
|
| + * @param ampms the new ampm strings. (not adopted; caller retains ownership)
|
| + * @param count Filled in with length of the array.
|
| + * @stable ICU 2.0
|
| + */
|
| + void setAmPmStrings(const UnicodeString* ampms, int32_t count);
|
| +
|
| + /**
|
| + * Gets timezone strings. These strings are stored in a 2-dimensional array.
|
| + * @param rowCount Output param to receive number of rows.
|
| + * @param columnCount Output param to receive number of columns.
|
| + * @return The timezone strings as a 2-d array. (DateFormatSymbols retains ownership.)
|
| + * @deprecated ICU 3.6
|
| + */
|
| + const UnicodeString** getZoneStrings(int32_t& rowCount, int32_t& columnCount) const;
|
| +
|
| + /**
|
| + * Sets timezone strings. These strings are stored in a 2-dimensional array.
|
| + * @param strings The timezone strings as a 2-d array to be copied. (not adopted; caller retains ownership)
|
| + * @param rowCount The number of rows (count of first index).
|
| + * @param columnCount The number of columns (count of second index).
|
| + * @stable ICU 2.0
|
| + */
|
| + void setZoneStrings(const UnicodeString* const* strings, int32_t rowCount, int32_t columnCount);
|
| +
|
| + /**
|
| + * Get the non-localized date-time pattern characters.
|
| + * @return the non-localized date-time pattern characters
|
| + * @stable ICU 2.0
|
| + */
|
| + static const UChar * U_EXPORT2 getPatternUChars(void);
|
| +
|
| + /**
|
| + * Gets localized date-time pattern characters. For example: 'u', 't', etc.
|
| + * <p>
|
| + * 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.
|
| + * @param result Output param which will receive the localized date-time pattern characters.
|
| + * @return A reference to 'result'.
|
| + * @stable ICU 2.0
|
| + */
|
| + UnicodeString& getLocalPatternChars(UnicodeString& result) const;
|
| +
|
| + /**
|
| + * Sets localized date-time pattern characters. For example: 'u', 't', etc.
|
| + * @param newLocalPatternChars the new localized date-time
|
| + * pattern characters.
|
| + * @stable ICU 2.0
|
| + */
|
| + void setLocalPatternChars(const UnicodeString& newLocalPatternChars);
|
| +
|
| + /**
|
| + * Returns the locale for this object. Two flavors are available:
|
| + * valid and actual locale.
|
| + * @stable ICU 2.8
|
| + */
|
| + Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const;
|
| +
|
| + /**
|
| + * ICU "poor man's RTTI", returns a UClassID for the actual class.
|
| + *
|
| + * @stable ICU 2.2
|
| + */
|
| + virtual UClassID getDynamicClassID() const;
|
| +
|
| + /**
|
| + * ICU "poor man's RTTI", returns a UClassID for this class.
|
| + *
|
| + * @stable ICU 2.2
|
| + */
|
| + static UClassID U_EXPORT2 getStaticClassID();
|
| +
|
| +private:
|
| +
|
| + friend class SimpleDateFormat;
|
| + friend class DateFormatSymbolsSingleSetter; // see udat.cpp
|
| +
|
| + /**
|
| + * Abbreviated era strings. For example: "AD" and "BC".
|
| + */
|
| + UnicodeString* fEras;
|
| + int32_t fErasCount;
|
| +
|
| + /**
|
| + * Era name strings. For example: "Anno Domini" and "Before Christ".
|
| + */
|
| + UnicodeString* fEraNames;
|
| + int32_t fEraNamesCount;
|
| +
|
| + /**
|
| + * Narrow era strings. For example: "A" and "B".
|
| + */
|
| + UnicodeString* fNarrowEras;
|
| + int32_t fNarrowErasCount;
|
| +
|
| + /**
|
| + * Month strings. For example: "January", "February", etc.
|
| + */
|
| + UnicodeString* fMonths;
|
| + int32_t fMonthsCount;
|
| +
|
| + /**
|
| + * Short month strings. For example: "Jan", "Feb", etc.
|
| + */
|
| + UnicodeString* fShortMonths;
|
| + int32_t fShortMonthsCount;
|
| +
|
| + /**
|
| + * Narrow month strings. For example: "J", "F", etc.
|
| + */
|
| + UnicodeString* fNarrowMonths;
|
| + int32_t fNarrowMonthsCount;
|
| +
|
| + /**
|
| + * Standalone Month strings. For example: "January", "February", etc.
|
| + */
|
| + UnicodeString* fStandaloneMonths;
|
| + int32_t fStandaloneMonthsCount;
|
| +
|
| + /**
|
| + * Standalone Short month strings. For example: "Jan", "Feb", etc.
|
| + */
|
| + UnicodeString* fStandaloneShortMonths;
|
| + int32_t fStandaloneShortMonthsCount;
|
| +
|
| + /**
|
| + * Standalone Narrow month strings. For example: "J", "F", etc.
|
| + */
|
| + UnicodeString* fStandaloneNarrowMonths;
|
| + int32_t fStandaloneNarrowMonthsCount;
|
| +
|
| + /**
|
| + * Weekday strings. For example: "Sunday", "Monday", etc.
|
| + */
|
| + UnicodeString* fWeekdays;
|
| + int32_t fWeekdaysCount;
|
| +
|
| + /**
|
| + * Short weekday strings. For example: "Sun", "Mon", etc.
|
| + */
|
| + UnicodeString* fShortWeekdays;
|
| + int32_t fShortWeekdaysCount;
|
| +
|
| + /**
|
| + * Narrow weekday strings. For example: "Sun", "Mon", etc.
|
| + */
|
| + UnicodeString* fNarrowWeekdays;
|
| + int32_t fNarrowWeekdaysCount;
|
| +
|
| + /**
|
| + * Standalone Weekday strings. For example: "Sunday", "Monday", etc.
|
| + */
|
| + UnicodeString* fStandaloneWeekdays;
|
| + int32_t fStandaloneWeekdaysCount;
|
| +
|
| + /**
|
| + * Standalone Short weekday strings. For example: "Sun", "Mon", etc.
|
| + */
|
| + UnicodeString* fStandaloneShortWeekdays;
|
| + int32_t fStandaloneShortWeekdaysCount;
|
| +
|
| + /**
|
| + * Standalone Narrow weekday strings. For example: "Sun", "Mon", etc.
|
| + */
|
| + UnicodeString* fStandaloneNarrowWeekdays;
|
| + int32_t fStandaloneNarrowWeekdaysCount;
|
| +
|
| + /**
|
| + * Ampm strings. For example: "AM" and "PM".
|
| + */
|
| + UnicodeString* fAmPms;
|
| + int32_t fAmPmsCount;
|
| +
|
| + /**
|
| + * Quarter strings. For example: "1st quarter", "2nd quarter", etc.
|
| + */
|
| + UnicodeString *fQuarters;
|
| + int32_t fQuartersCount;
|
| +
|
| + /**
|
| + * Short quarters. For example: "Q1", "Q2", etc.
|
| + */
|
| + UnicodeString *fShortQuarters;
|
| + int32_t fShortQuartersCount;
|
| +
|
| + /**
|
| + * Standalone quarter strings. For example: "1st quarter", "2nd quarter", etc.
|
| + */
|
| + UnicodeString *fStandaloneQuarters;
|
| + int32_t fStandaloneQuartersCount;
|
| +
|
| + /**
|
| + * Standalone short quarter strings. For example: "Q1", "Q2", etc.
|
| + */
|
| + UnicodeString *fStandaloneShortQuarters;
|
| + int32_t fStandaloneShortQuartersCount;
|
| +
|
| + /**
|
| + * Localized names of time zones in this locale. This is a
|
| + * two-dimensional array of strings of size n by m,
|
| + * where m is at least 5 and up to 7. 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
|
| + * example: America/Los_Angeles
|
| + * zoneStrings[i][1] - long name of zone in standard time
|
| + * example: Pacific Standard Time
|
| + * zoneStrings[i][2] - short name of zone in standard time
|
| + * example: PST
|
| + * zoneStrings[i][3] - long name of zone in daylight savings time
|
| + * example: Pacific Daylight Time
|
| + * zoneStrings[i][4] - short name of zone in daylight savings time
|
| + * example: PDT
|
| + * zoneStrings[i][5] - location name of zone
|
| + * example: United States (Los Angeles)
|
| + * zoneStrings[i][6] - long generic name of zone
|
| + * example: Pacific Time
|
| + * zoneStrings[i][7] - short generic of zone
|
| + * example: PT
|
| + *
|
| + * The zone ID is not localized; it corresponds to the ID
|
| + * value associated with a system time zone object. All other entries
|
| + * are localized names. If a zone does not implement daylight savings
|
| + * time, the daylight savings time names are ignored.
|
| + *
|
| + * Note:CLDR 1.5 introduced metazone and its historical mappings.
|
| + * This simple two-dimensional array is no longer sufficient to represent
|
| + * localized names and its historic changes. Since ICU 3.8.1, localized
|
| + * zone names extracted from ICU locale data is stored in a ZoneStringFormat
|
| + * instance. But we still need to support the old way of customizing
|
| + * localized zone names, so we keep this field for the purpose.
|
| + */
|
| + UnicodeString **fZoneStrings; // Zone string array set by setZoneStrings
|
| + UnicodeString **fLocaleZoneStrings; // Zone string array created by the locale
|
| + int32_t fZoneStringsRowCount;
|
| + int32_t fZoneStringsColCount;
|
| +
|
| + const ZoneStringFormat *fZoneStringFormat;
|
| + ZoneStringFormat *fZSFLocal; // Local ZoneStringFormat instance
|
| + SafeZoneStringFormatPtr *fZSFCachePtr; // Cached ZoneStringFormat
|
| + Locale fZSFLocale; // Locale used for getting ZoneStringFormat
|
| +
|
| + /**
|
| + * Pattern string used for localized time zone GMT format. For example, "GMT{0}"
|
| + */
|
| + UnicodeString fGmtFormat;
|
| +
|
| + /**
|
| + * Pattern strings used for formatting zone offset in a localized time zone GMT string.
|
| + */
|
| + UnicodeString *fGmtHourFormats;
|
| + int32_t fGmtHourFormatsCount;
|
| +
|
| + enum GMTHourType {
|
| + GMT_NEGATIVE_HMS = 0,
|
| + GMT_NEGATIVE_HM,
|
| + GMT_POSITIVE_HMS,
|
| + GMT_POSITIVE_HM,
|
| + GMT_HOUR_COUNT
|
| + };
|
| +
|
| + /**
|
| + * Localized date-time pattern characters. For example: use 'u' as 'y'.
|
| + */
|
| + UnicodeString fLocalPatternChars;
|
| +
|
| +private:
|
| + /** valid/actual locale information
|
| + * these are always ICU locales, so the length should not be a problem
|
| + */
|
| + char validLocale[ULOC_FULLNAME_CAPACITY];
|
| + char actualLocale[ULOC_FULLNAME_CAPACITY];
|
| +
|
| + DateFormatSymbols(); // default constructor not implemented
|
| +
|
| + /**
|
| + * Called by the constructors to actually load data from the resources
|
| + *
|
| + * @param locale The locale to get symbols for.
|
| + * @param type Calendar Type (as from Calendar::getType())
|
| + * @param status Input/output parameter, set to success or
|
| + * failure code upon return.
|
| + * @param useLastResortData determine if use last resort data
|
| + */
|
| + void initializeData(const Locale&, const char *type, UErrorCode& status, UBool useLastResortData = FALSE);
|
| +
|
| + /**
|
| + * Copy or alias an array in another object, as appropriate.
|
| + *
|
| + * @param dstArray the copy destination array.
|
| + * @param dstCount fill in with the lenth of 'dstArray'.
|
| + * @param srcArray the source array to be copied.
|
| + * @param srcCount the length of items to be copied from the 'srcArray'.
|
| + */
|
| + static void assignArray(UnicodeString*& dstArray,
|
| + int32_t& dstCount,
|
| + const UnicodeString* srcArray,
|
| + int32_t srcCount);
|
| +
|
| + /**
|
| + * Return true if the given arrays' contents are equal, or if the arrays are
|
| + * identical (pointers are equal).
|
| + *
|
| + * @param array1 one array to be compared with.
|
| + * @param array2 another array to be compared with.
|
| + * @param count the length of items to be copied.
|
| + * @return true if the given arrays' contents are equal, or if the arrays are
|
| + * identical (pointers are equal).
|
| + */
|
| + static UBool arrayCompare(const UnicodeString* array1,
|
| + const UnicodeString* array2,
|
| + int32_t count);
|
| +
|
| + /**
|
| + * Create a copy, in fZoneStrings, of the given zone strings array. The
|
| + * member variables fZoneStringsRowCount and fZoneStringsColCount should be
|
| + * set already by the caller.
|
| + */
|
| + void createZoneStrings(const UnicodeString *const * otherStrings);
|
| +
|
| + /**
|
| + * Delete all the storage owned by this object.
|
| + */
|
| + void dispose(void);
|
| +
|
| + /**
|
| + * Copy all of the other's data to this.
|
| + * @param other the object to be copied.
|
| + */
|
| + void copyData(const DateFormatSymbols& other);
|
| +
|
| +
|
| + /**
|
| + * Returns a ZoneStringFormat, used only by SimpleDateFormat for now.
|
| + */
|
| + const ZoneStringFormat* getZoneStringFormat(void) const;
|
| +
|
| + /**
|
| + * Create a ZoneStringFormat by locale if not yet availble
|
| + */
|
| + void initZoneStringFormat(void);
|
| +
|
| + /**
|
| + * Create zone strings array by locale if not yet available
|
| + */
|
| + void initZoneStringsArray(void);
|
| +
|
| + /**
|
| + * Delete just the zone strings.
|
| + */
|
| + void disposeZoneStrings(void);
|
| +};
|
| +
|
| +U_NAMESPACE_END
|
| +
|
| +#endif /* #if !UCONFIG_NO_FORMATTING */
|
| +
|
| +#endif // _DTFMTSYM
|
| +//eof
|
|
|
| Property changes on: icu46/source/i18n/unicode/dtfmtsym.h
|
| ___________________________________________________________________
|
| Added: svn:eol-style
|
| + LF
|
|
|
|
|