1999-12-28 23:57:50 +00:00
|
|
|
/*
|
|
|
|
********************************************************************************
|
2005-03-08 22:49:59 +00:00
|
|
|
* Copyright (C) 1997-2005, International Business Machines
|
1999-12-28 23:57:50 +00:00
|
|
|
* 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"
|
2002-09-20 01:54:48 +00:00
|
|
|
|
|
|
|
#if !UCONFIG_NO_FORMATTING
|
|
|
|
|
2002-06-27 01:19:20 +00:00
|
|
|
#include "unicode/uobject.h"
|
1999-12-28 23:57:50 +00:00
|
|
|
#include "unicode/locid.h"
|
2004-08-31 18:04:12 +00:00
|
|
|
#include "unicode/ures.h"
|
1999-12-28 23:57:50 +00:00
|
|
|
|
2005-06-22 22:39:36 +00:00
|
|
|
/**
|
|
|
|
* \file
|
|
|
|
* \brief C++ API: Symbols for formatting dates.
|
|
|
|
*/
|
|
|
|
|
2001-10-08 23:26:58 +00:00
|
|
|
U_NAMESPACE_BEGIN
|
|
|
|
|
2000-01-18 19:57:46 +00:00
|
|
|
/* forward declaration */
|
|
|
|
class SimpleDateFormat;
|
2005-08-26 21:55:55 +00:00
|
|
|
class Hashtable;
|
2000-01-18 19:57:46 +00:00
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* 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>
|
2003-05-25 07:12:19 +00:00
|
|
|
* 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.
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
2002-06-27 01:19:20 +00:00
|
|
|
class U_I18N_API DateFormatSymbols : public UObject {
|
1999-12-28 23:57:50 +00:00
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* Construct a DateFormatSymbols object by loading format data from
|
2003-05-15 22:30:24 +00:00
|
|
|
* resources for the default locale, in the default calendar (Gregorian).
|
1999-12-28 23:57:50 +00:00
|
|
|
* <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.
|
|
|
|
*
|
2003-05-25 07:12:19 +00:00
|
|
|
* @param status Status code. Failure
|
1999-12-28 23:57:50 +00:00
|
|
|
* results if the resources for the default cannot be
|
|
|
|
* found or cannot be loaded
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
DateFormatSymbols(UErrorCode& status);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Construct a DateFormatSymbols object by loading format data from
|
2003-05-15 22:30:24 +00:00
|
|
|
* resources for the given locale, in the default calendar (Gregorian).
|
1999-12-28 23:57:50 +00:00
|
|
|
*
|
|
|
|
* @param locale Locale to load format data from.
|
2003-05-25 07:12:19 +00:00
|
|
|
* @param status Status code. Failure
|
1999-12-28 23:57:50 +00:00
|
|
|
* results if the resources for the locale cannot be
|
|
|
|
* found or cannot be loaded
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
DateFormatSymbols(const Locale& locale,
|
|
|
|
UErrorCode& status);
|
|
|
|
|
2003-05-15 22:30:24 +00:00
|
|
|
/**
|
|
|
|
* 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".)
|
2003-05-25 07:12:19 +00:00
|
|
|
* @param status Status code. Failure
|
2003-05-15 22:30:24 +00:00
|
|
|
* results if the resources for the default cannot be
|
|
|
|
* found or cannot be loaded
|
2003-05-25 07:12:19 +00:00
|
|
|
* @internal
|
2003-05-15 22:30:24 +00:00
|
|
|
*/
|
|
|
|
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".)
|
2003-05-25 07:12:19 +00:00
|
|
|
* @param status Status code. Failure
|
2003-05-15 22:30:24 +00:00
|
|
|
* results if the resources for the locale cannot be
|
|
|
|
* found or cannot be loaded
|
2003-05-25 07:12:19 +00:00
|
|
|
* @internal
|
2003-05-15 22:30:24 +00:00
|
|
|
*/
|
|
|
|
DateFormatSymbols(const Locale& locale,
|
|
|
|
const char *type,
|
|
|
|
UErrorCode& status);
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* Copy constructor.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
DateFormatSymbols(const DateFormatSymbols&);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Assignment operator.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
DateFormatSymbols& operator=(const DateFormatSymbols&);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Destructor. This is nonvirtual because this class is not designed to be
|
|
|
|
* subclassed.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
2004-08-27 16:45:16 +00:00
|
|
|
virtual ~DateFormatSymbols();
|
1999-12-28 23:57:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return true if another object is semantically equal to this one.
|
2002-07-01 11:04:45 +00:00
|
|
|
*
|
|
|
|
* @param other the DateFormatSymbols object to be compared with.
|
|
|
|
* @return true if other is semantically equal to this.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
2000-05-18 22:08:39 +00:00
|
|
|
UBool operator==(const DateFormatSymbols& other) const;
|
1999-12-28 23:57:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return true if another object is semantically unequal to this one.
|
2002-07-01 11:04:45 +00:00
|
|
|
*
|
|
|
|
* @param other the DateFormatSymbols object to be compared with.
|
|
|
|
* @return true if other is semantically unequal to this.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
2000-05-18 22:08:39 +00:00
|
|
|
UBool operator!=(const DateFormatSymbols& other) const { return !operator==(other); }
|
1999-12-28 23:57:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets era strings. For example: "AD" and "BC".
|
2002-07-01 11:04:45 +00:00
|
|
|
*
|
|
|
|
* @param count Filled in with length of the array.
|
|
|
|
* @return the era strings.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
const UnicodeString* getEras(int32_t& count) const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets 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.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void setEras(const UnicodeString* eras, int32_t count);
|
|
|
|
|
2005-06-24 21:39:08 +00:00
|
|
|
/**
|
|
|
|
* 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.
|
|
|
|
* @draft ICU 3.4
|
|
|
|
*/
|
|
|
|
const UnicodeString* getEraNames(int32_t& count) const;
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* Gets month strings. For example: "January", "February", etc.
|
|
|
|
* @param count Filled in with length of the array.
|
|
|
|
* @return the month strings. (DateFormatSymbols retains ownership.)
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
const UnicodeString* getMonths(int32_t& count) const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets month strings. For example: "January", "February", etc.
|
2002-07-01 11:04:45 +00:00
|
|
|
*
|
|
|
|
* @param months the new month strings. (not adopted; caller retains ownership)
|
|
|
|
* @param count Filled in with length of the array.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void setMonths(const UnicodeString* months, int32_t count);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets short month strings. For example: "Jan", "Feb", etc.
|
2002-07-01 11:04:45 +00:00
|
|
|
*
|
|
|
|
* @param count Filled in with length of the array.
|
1999-12-28 23:57:50 +00:00
|
|
|
* @return the short month strings. (DateFormatSymbols retains ownership.)
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
const UnicodeString* getShortMonths(int32_t& count) const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets short month strings. For example: "Jan", "Feb", etc.
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param count Filled in with length of the array.
|
|
|
|
* @param shortMonths the new short month strings. (not adopted; caller retains ownership)
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void setShortMonths(const UnicodeString* shortMonths, int32_t count);
|
|
|
|
|
2005-06-24 21:39:08 +00:00
|
|
|
enum DtContextType {
|
|
|
|
/**
|
|
|
|
* Selector for format date context
|
|
|
|
* @draft ICU 3.4
|
|
|
|
*/
|
|
|
|
FORMAT = 0,
|
|
|
|
/**
|
|
|
|
* Selector for standalone date context
|
|
|
|
* @draft ICU 3.4
|
|
|
|
*/
|
|
|
|
STANDALONE = 1
|
|
|
|
};
|
|
|
|
|
|
|
|
enum DtWidthType {
|
|
|
|
/**
|
|
|
|
* Selector for wide strings
|
|
|
|
* @draft ICU 3.4
|
|
|
|
*/
|
|
|
|
WIDE = 4,
|
|
|
|
/**
|
|
|
|
* Selector for abbreviated strings
|
|
|
|
* @draft ICU 3.4
|
|
|
|
*/
|
|
|
|
ABBREVIATED = 3,
|
|
|
|
/**
|
|
|
|
* Selector for narrow strings
|
|
|
|
* @draft ICU 3.4
|
|
|
|
*/
|
|
|
|
NARROW = 5
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets month strings by width and context. For example: "January", "February", etc.
|
|
|
|
* @param count Filled in with length of the array.
|
|
|
|
* @param context The day 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.)
|
|
|
|
* @draft ICU 3.4
|
|
|
|
*/
|
|
|
|
const UnicodeString* getMonths(int32_t& count, DtContextType context, DtWidthType width) const;
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* Gets weekday strings. For example: "Sunday", "Monday", etc.
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param count Filled in with length of the array.
|
1999-12-28 23:57:50 +00:00
|
|
|
* @return the weekday strings. (DateFormatSymbols retains ownership.)
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
const UnicodeString* getWeekdays(int32_t& count) const;
|
|
|
|
|
2005-06-24 21:39:08 +00:00
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* Sets weekday strings. For example: "Sunday", "Monday", etc.
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param weekdays the new weekday strings. (not adopted; caller retains ownership)
|
|
|
|
* @param count Filled in with length of the array.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void setWeekdays(const UnicodeString* weekdays, int32_t count);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets short weekday strings. For example: "Sun", "Mon", etc.
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param count Filled in with length of the array.
|
|
|
|
* @return the short weekday strings. (DateFormatSymbols retains ownership.)
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
const UnicodeString* getShortWeekdays(int32_t& count) const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets short weekday strings. For example: "Sun", "Mon", etc.
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param shortWeekdays the new short weekday strings. (not adopted; caller retains ownership)
|
|
|
|
* @param count Filled in with length of the array.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void setShortWeekdays(const UnicodeString* shortWeekdays, int32_t count);
|
|
|
|
|
2005-06-24 21:39:08 +00:00
|
|
|
/**
|
|
|
|
* Gets weekday strings by width and context. For example: "Sunday", "Monday", etc.
|
|
|
|
* @param count Filled in with length of the array.
|
|
|
|
* @param context The day 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.)
|
|
|
|
* @draft ICU 3.4
|
|
|
|
*/
|
|
|
|
const UnicodeString* getWeekdays(int32_t& count, DtContextType context, DtWidthType width) const;
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* Gets AM/PM strings. For example: "AM" and "PM".
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param count Filled in with length of the array.
|
|
|
|
* @return the weekday strings. (DateFormatSymbols retains ownership.)
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
const UnicodeString* getAmPmStrings(int32_t& count) const;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets ampm strings. For example: "AM" and "PM".
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param ampms the new ampm strings. (not adopted; caller retains ownership)
|
|
|
|
* @param count Filled in with length of the array.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
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.)
|
2005-08-26 21:55:55 +00:00
|
|
|
* @deprecated ICU 3.6
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
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).
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void setZoneStrings(const UnicodeString* const* strings, int32_t rowCount, int32_t columnCount);
|
|
|
|
|
2001-09-18 21:36:45 +00:00
|
|
|
/**
|
|
|
|
* Get the non-localized date-time pattern characters.
|
2002-07-01 11:04:45 +00:00
|
|
|
* @return the non-localized date-time pattern characters
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
2001-09-18 21:36:45 +00:00
|
|
|
*/
|
2004-08-24 17:38:33 +00:00
|
|
|
static const UChar * U_EXPORT2 getPatternUChars(void);
|
2001-09-18 21:36:45 +00:00
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* Gets localized date-time pattern characters. For example: 'u', 't', etc.
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param result Output param which will receive the localized date-time pattern characters.
|
|
|
|
* @return A reference to 'result'.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
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.
|
2002-12-04 23:46:16 +00:00
|
|
|
* @stable ICU 2.0
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void setLocalPatternChars(const UnicodeString& newLocalPatternChars);
|
|
|
|
|
2004-01-20 23:06:38 +00:00
|
|
|
/**
|
|
|
|
* Returns the locale for this object. Two flavors are available:
|
|
|
|
* valid and actual locale.
|
2005-06-22 23:38:06 +00:00
|
|
|
* @draft ICU 2.8 likely to change after ICU 3.0, based on feedback
|
2004-01-20 23:06:38 +00:00
|
|
|
*/
|
|
|
|
Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const;
|
|
|
|
|
2002-06-29 00:04:16 +00:00
|
|
|
/**
|
|
|
|
* ICU "poor man's RTTI", returns a UClassID for the actual class.
|
|
|
|
*
|
2003-11-18 02:37:24 +00:00
|
|
|
* @stable ICU 2.2
|
2002-06-29 00:04:16 +00:00
|
|
|
*/
|
2003-10-07 15:49:47 +00:00
|
|
|
virtual UClassID getDynamicClassID() const;
|
2002-06-29 00:04:16 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* ICU "poor man's RTTI", returns a UClassID for this class.
|
|
|
|
*
|
2003-11-18 02:37:24 +00:00
|
|
|
* @stable ICU 2.2
|
2002-06-29 00:04:16 +00:00
|
|
|
*/
|
2004-08-24 17:38:33 +00:00
|
|
|
static UClassID U_EXPORT2 getStaticClassID();
|
2002-06-29 00:04:16 +00:00
|
|
|
|
2005-08-26 21:55:55 +00:00
|
|
|
/**
|
|
|
|
* The translation type of the translated zone strings
|
|
|
|
* @internal ICU 3.6
|
|
|
|
*/
|
|
|
|
enum TimeZoneTranslationType {
|
|
|
|
TIMEZONE_SHORT_GENERIC,
|
|
|
|
TIMEZONE_SHORT_STANDARD,
|
|
|
|
TIMEZONE_SHORT_DAYLIGHT,
|
|
|
|
TIMEZONE_LONG_GENERIC,
|
|
|
|
TIMEZONE_LONG_STANDARD,
|
|
|
|
TIMEZONE_LONG_DAYLIGHT,
|
|
|
|
TIMEZONE_EXEMPLAR_CITY,
|
|
|
|
TIMEZONE_COUNT
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Creates an enumeration of time zone IDs. The object is owned by the caller and should delete it after use.
|
|
|
|
* The time zone IDs are just for programmatic lookup. NOT LOCALIZED!!!
|
|
|
|
* @param status Input/output parameter, set to success or
|
|
|
|
* failure code upon return.
|
|
|
|
* @return A new StringEnumeration object
|
|
|
|
* @internal ICU 3.6
|
|
|
|
*/
|
|
|
|
virtual StringEnumeration* createZoneStringIDs(UErrorCode &status);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Gets timezone string give the key and translation type
|
|
|
|
* @param ID The ID of zone strings, e.g: "America/Los_Angeles".
|
|
|
|
* The time zone ID is for programmatic lookup.
|
|
|
|
* @param type The translation type requested
|
|
|
|
* @param result Output parameter to recieve the translation string
|
|
|
|
* @param status Input/output parameter, set to success or
|
|
|
|
* failure code upon return.
|
|
|
|
* @return the input UnicodeString parameter for chaining
|
|
|
|
* @internal ICU 3.6
|
|
|
|
*/
|
|
|
|
UnicodeString& getZoneString(const UnicodeString &ID, const TimeZoneTranslationType type, UnicodeString &result, UErrorCode &status);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets timezone string for the given the ID and translation type
|
|
|
|
* @param ID The ID of zone strings, e.g: "America/Los_Angeles".
|
|
|
|
* The time zone ID is for programmatic lookup.
|
|
|
|
* @param type The translation type to set the value for
|
|
|
|
* @param value The string with which current translation needs to be replaced
|
|
|
|
* @param status Input/output parameter, set to success or
|
|
|
|
* @internal ICU 3.6
|
|
|
|
*/
|
|
|
|
void setZoneString(const UnicodeString &ID, const TimeZoneTranslationType type, const UnicodeString &value, UErrorCode &status);
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
private:
|
2001-08-10 23:00:30 +00:00
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
friend class SimpleDateFormat;
|
2002-10-15 00:36:11 +00:00
|
|
|
friend class DateFormatSymbolsSingleSetter; // see udat.cpp
|
1999-12-28 23:57:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Era strings. For example: "AD" and "BC".
|
|
|
|
*/
|
|
|
|
UnicodeString* fEras;
|
|
|
|
int32_t fErasCount;
|
|
|
|
|
2005-06-24 21:39:08 +00:00
|
|
|
/**
|
|
|
|
* Era name strings. For example: "Anno Domini" and "Before Christ".
|
|
|
|
*/
|
|
|
|
UnicodeString* fEraNames;
|
|
|
|
int32_t fEraNamesCount;
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* 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;
|
|
|
|
|
2005-06-24 21:39:08 +00:00
|
|
|
/**
|
|
|
|
* 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;
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* 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;
|
|
|
|
|
2005-06-24 21:39:08 +00:00
|
|
|
/**
|
|
|
|
* 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;
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* Ampm strings. For example: "AM" and "PM".
|
|
|
|
*/
|
|
|
|
UnicodeString* fAmPms;
|
|
|
|
int32_t fAmPmsCount;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* The format data of all the timezones in this locale.
|
|
|
|
*/
|
|
|
|
UnicodeString** fZoneStrings;
|
|
|
|
int32_t fZoneStringsRowCount;
|
|
|
|
int32_t fZoneStringsColCount;
|
2005-08-26 21:55:55 +00:00
|
|
|
StringEnumeration* fZoneIDEnumeration;
|
|
|
|
Hashtable* fZoneStringsHash;
|
|
|
|
UResourceBundle* fZoneArrayBundle;
|
|
|
|
struct VectorItem{
|
|
|
|
UnicodeString value;
|
|
|
|
TimeZoneTranslationType type;
|
|
|
|
VectorItem* next;
|
|
|
|
};
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* Localized date-time pattern characters. For example: use 'u' as 'y'.
|
|
|
|
*/
|
|
|
|
UnicodeString fLocalPatternChars;
|
|
|
|
|
|
|
|
private:
|
2003-11-19 23:51:38 +00:00
|
|
|
/** valid/actual locale information
|
|
|
|
* these are always ICU locales, so the length should not be a problem
|
|
|
|
*/
|
2004-01-12 22:39:41 +00:00
|
|
|
char validLocale[ULOC_FULLNAME_CAPACITY];
|
|
|
|
char actualLocale[ULOC_FULLNAME_CAPACITY];
|
2003-11-19 23:51:38 +00:00
|
|
|
|
2003-05-04 01:40:40 +00:00
|
|
|
DateFormatSymbols(); // default constructor not implemented
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
|
|
|
* Called by the constructors to actually load data from the resources
|
2002-07-01 11:04:45 +00:00
|
|
|
*
|
|
|
|
* @param locale The locale to get symbols for.
|
2003-05-15 22:30:24 +00:00
|
|
|
* @param type Calendar Type (as from Calendar::getType())
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param status Input/output parameter, set to success or
|
|
|
|
* failure code upon return.
|
|
|
|
* @param useLastResortData determine if use last resort data
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
2003-05-15 22:30:24 +00:00
|
|
|
void initializeData(const Locale&, const char *type, UErrorCode& status, UBool useLastResortData = FALSE);
|
1999-12-28 23:57:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Copy or alias an array in another object, as appropriate.
|
2002-07-01 11:04:45 +00:00
|
|
|
*
|
|
|
|
* @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'.
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
2001-06-19 17:38:29 +00:00
|
|
|
static void assignArray(UnicodeString*& dstArray,
|
|
|
|
int32_t& dstCount,
|
|
|
|
const UnicodeString* srcArray,
|
|
|
|
int32_t srcCount);
|
1999-12-28 23:57:50 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Return true if the given arrays' contents are equal, or if the arrays are
|
|
|
|
* identical (pointers are equal).
|
2002-07-01 11:04:45 +00:00
|
|
|
*
|
|
|
|
* @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).
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
2000-05-18 22:08:39 +00:00
|
|
|
static UBool arrayCompare(const UnicodeString* array1,
|
1999-12-28 23:57:50 +00:00
|
|
|
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
|
2002-10-15 00:36:11 +00:00
|
|
|
* set already by the caller.
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void createZoneStrings(const UnicodeString *const * otherStrings);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Package private: used by SimpleDateFormat
|
|
|
|
* Gets the index for the given time zone ID to obtain the timezone
|
|
|
|
* strings for formatting. The time zone ID is just for programmatic
|
|
|
|
* lookup. NOT LOCALIZED!!!
|
|
|
|
* @param ID the given time zone ID.
|
|
|
|
* @return the index of the given time zone ID. Returns -1 if
|
|
|
|
* the given time zone ID can't be located in the DateFormatSymbols object.
|
|
|
|
* @see java.util.SimpleTimeZone
|
|
|
|
*/
|
|
|
|
int32_t getZoneIndex(const UnicodeString& ID) const;
|
|
|
|
|
2000-09-27 19:16:54 +00:00
|
|
|
// Internal method; see source for documentation
|
|
|
|
int32_t _getZoneIndex(const UnicodeString& id) const;
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
2002-10-15 00:36:11 +00:00
|
|
|
* Delete all the storage owned by this object.
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void dispose(void);
|
|
|
|
|
2001-06-19 17:38:29 +00:00
|
|
|
/**
|
|
|
|
* Copy all of the other's data to this.
|
2002-07-01 11:04:45 +00:00
|
|
|
* @param other the object to be copied.
|
2001-06-19 17:38:29 +00:00
|
|
|
*/
|
|
|
|
void copyData(const DateFormatSymbols& other);
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
/**
|
2002-10-15 00:36:11 +00:00
|
|
|
* Delete just the zone strings.
|
1999-12-28 23:57:50 +00:00
|
|
|
*/
|
|
|
|
void disposeZoneStrings(void);
|
2005-08-26 21:55:55 +00:00
|
|
|
/**
|
|
|
|
* Initializes the zoneStrings hash and keys StringEnumeration after reading the zoneStrings resource
|
|
|
|
*/
|
|
|
|
void initZoneStrings(UResourceBundle* bundle, const UChar* lastResortStrings, int32_t length, UErrorCode &status);
|
|
|
|
/**
|
|
|
|
* initialzes the zoneStrings has and keys enumeration after reading the strings[][]. Required for backwards
|
|
|
|
* compatibility of setZoneStrings method
|
|
|
|
*/
|
|
|
|
void initZoneStrings(const UnicodeString** strings, int32_t rowCount, int32_t collumnCount);
|
|
|
|
/**
|
|
|
|
* initialization of the fZoneStrings data member
|
|
|
|
*/
|
|
|
|
void initZoneStringsArray(UErrorCode& status);
|
|
|
|
/**
|
|
|
|
* Creates a deep clone of the Hashtable
|
|
|
|
*/
|
|
|
|
Hashtable* createZoneStringsHash(const Hashtable* otherHash);
|
|
|
|
/**
|
|
|
|
* compares 2 StringEnumerations
|
|
|
|
*/
|
|
|
|
static UBool stringEnumCompare(StringEnumeration* enum1, StringEnumeration* enum2);
|
|
|
|
/**
|
|
|
|
* compares 2 Hashtables
|
|
|
|
*/
|
|
|
|
static UBool hashCompare(Hashtable* hash1, Hashtable* hash2);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Fetches the key from the hashtable for a given ID.
|
|
|
|
* e.g: for a given ID such as PST returns "Americal/Los_Angeles"
|
|
|
|
* Used by SimpleDateFormat class.
|
|
|
|
* @param ID The id of the time zone for which the key needs to be fetched
|
|
|
|
* @param result Output parameter to recieve the key.
|
|
|
|
* @return the input UnicodeString object for chaining
|
|
|
|
*/
|
|
|
|
UnicodeString& getZoneID(const UnicodeString& zid, UnicodeString& result, UErrorCode& status);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Fetches the zone type and zone string from the hashtable for a given key.
|
|
|
|
* e.g: for key: "Americal/Los_Angeles", text: "2004/1/1 PT 1:00" and start:9
|
|
|
|
* returns TIMEZONE_SHORT_GENERIC and "PT".
|
|
|
|
* Used by SimpleDateFormat class.
|
|
|
|
* @param ID the name of the timezone
|
|
|
|
* @param text the string containing the time zone translation
|
|
|
|
* @param start The position in string where time zone string starts
|
|
|
|
* @param type output parameter to recieve the type of time zone string
|
|
|
|
* @param value output parameter to recieve the the acutal time zone string
|
|
|
|
*/
|
|
|
|
void getZoneType(const UnicodeString& zid, const UnicodeString& text, int32_t start, TimeZoneTranslationType& type, UnicodeString& value, UErrorCode& status);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Fetches the zone type and zone string from the hashtable by cycling through all elements in the hashtable.
|
|
|
|
* e.g: text: "2004/1/1 PT 1:00" and start:9
|
|
|
|
* returns "Americal/Los_Angeles", TIMEZONE_SHORT_GENERIC and "PT". Used by SimpleDateFormat class.
|
|
|
|
* Used by SimpleDateFormat class.
|
|
|
|
* @param ID output parameter to recieve the key name of the time zone
|
|
|
|
* @param text the string containing the time zone translation
|
|
|
|
* @param start The position in string where time zone string starts
|
|
|
|
* @param type output parameter to recieve the type of time zone string
|
|
|
|
* @param value output parameter to recieve the the acutal time zone string
|
|
|
|
* @param status output parameter to recive the error information
|
|
|
|
*/
|
|
|
|
void findZoneIDTypeValue(UnicodeString& zid, const UnicodeString& text, int32_t start, TimeZoneTranslationType& type, UnicodeString& value, UErrorCode& status);
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
};
|
|
|
|
|
2001-10-08 23:26:58 +00:00
|
|
|
U_NAMESPACE_END
|
|
|
|
|
2002-09-20 01:54:48 +00:00
|
|
|
#endif /* #if !UCONFIG_NO_FORMATTING */
|
|
|
|
|
1999-12-28 23:57:50 +00:00
|
|
|
#endif // _DTFMTSYM
|
|
|
|
//eof
|