1b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/*
2b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru********************************************************************************
31b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert*   Copyright (C) 1997-2015, International Business Machines
4b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*   Corporation and others.  All Rights Reserved.
5b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru********************************************************************************
6b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*
7b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* File DTFMTSYM.H
8b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*
9b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru* Modification History:
10b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*
11b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*   Date        Name        Description
12b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*   02/19/97    aliu        Converted from java.
13b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*    07/21/98    stephen        Added getZoneIndex()
14b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*                            Changed to match C++ conventions
15b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru********************************************************************************
16b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru*/
17b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
18b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#ifndef DTFMTSYM_H
19b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#define DTFMTSYM_H
20b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
21b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#include "unicode/utypes.h"
22b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
23b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#if !UCONFIG_NO_FORMATTING
24b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
25b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#include "unicode/calendar.h"
26b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#include "unicode/uobject.h"
27b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#include "unicode/locid.h"
2854dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius#include "unicode/udat.h"
29b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#include "unicode/ures.h"
30b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
31b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/**
32b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * \file
33b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * \brief C++ API: Symbols for formatting dates.
34b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */
35b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
36b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_NAMESPACE_BEGIN
37b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
38b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/* forward declaration */
39b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queruclass SimpleDateFormat;
40b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queruclass Hashtable;
41b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
42b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru/**
43b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * DateFormatSymbols is a public class for encapsulating localizable date-time
44b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * formatting data -- including timezone data. DateFormatSymbols is used by
45b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * DateFormat and SimpleDateFormat.
46b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * <P>
47b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Rather than first creating a DateFormatSymbols to get a date-time formatter
48b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * by using a SimpleDateFormat constructor, clients are encouraged to create a
49b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * date-time formatter using the getTimeInstance(), getDateInstance(), or
50b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * getDateTimeInstance() method in DateFormat. Each of these methods can return a
51b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * date/time formatter initialized with a default format pattern along with the
52b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * date-time formatting data for a given or default locale. After a formatter is
53b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * created, clients may modify the format pattern using the setPattern function
54b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * as so desired. For more information on using these formatter factory
55b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * functions, see DateFormat.
56b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * <P>
57b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * If clients decide to create a date-time formatter with a particular format
58b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * pattern and locale, they can do so with new SimpleDateFormat(aPattern,
59b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * new DateFormatSymbols(aLocale)).  This will load the appropriate date-time
60b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * formatting data from the locale.
61b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * <P>
62b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * DateFormatSymbols objects are clonable. When clients obtain a
63b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * DateFormatSymbols object, they can feel free to modify the date-time
64b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * formatting data as necessary. For instance, clients can
65b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * replace the localized date-time format pattern characters with the ones that
66b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * they feel easy to remember. Or they can change the representative cities
67b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * originally picked by default to using their favorite ones.
68b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * <P>
69b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * DateFormatSymbols are not expected to be subclassed. Data for a calendar is
70b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * loaded out of resource bundles.  The 'type' parameter indicates the type of
71b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * calendar, for example, "gregorian" or "japanese".  If the type is not gregorian
72b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * (or NULL, or an empty string) then the type is appended to the resource name,
73b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * for example,  'Eras_japanese' instead of 'Eras'.   If the resource 'Eras_japanese' did
74b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * not exist (even in root), then this class will fall back to just 'Eras', that is,
75b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * Gregorian data.  Therefore, the calendar implementor MUST ensure that the root
76b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * locale at least contains any resources that are to be particularized for the
77b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru * calendar type.
78b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru */
79f9878a236aa0d9662d8e40cafdaf2e04cd615835ccorneliusclass U_I18N_API DateFormatSymbols U_FINAL : public UObject  {
80b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Querupublic:
81b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
82b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Construct a DateFormatSymbols object by loading format data from
83b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * resources for the default locale, in the default calendar (Gregorian).
84b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * <P>
85b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * NOTE: This constructor will never fail; if it cannot get resource
86b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * data for the default locale, it will return a last-resort object
87b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * based on hard-coded strings.
88b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
89b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param status    Status code.  Failure
90b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  results if the resources for the default cannot be
91b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  found or cannot be loaded
92b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
93b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
94b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    DateFormatSymbols(UErrorCode& status);
95b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
96b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
97b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Construct a DateFormatSymbols object by loading format data from
98b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * resources for the given locale, in the default calendar (Gregorian).
99b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
100b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param locale    Locale to load format data from.
101b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param status    Status code.  Failure
102b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  results if the resources for the locale cannot be
103b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  found or cannot be loaded
104b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
105b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
106b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    DateFormatSymbols(const Locale& locale,
107b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru                      UErrorCode& status);
108b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
109103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius#ifndef U_HIDE_INTERNAL_API
110b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
111b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Construct a DateFormatSymbols object by loading format data from
112b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * resources for the default locale, in the default calendar (Gregorian).
113b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * <P>
114b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * NOTE: This constructor will never fail; if it cannot get resource
115b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * data for the default locale, it will return a last-resort object
116b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * based on hard-coded strings.
117b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
118b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param type      Type of calendar (as returned by Calendar::getType).
119b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  Will be used to access the correct set of strings.
120b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  (NULL or empty string defaults to "gregorian".)
121b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param status    Status code.  Failure
122b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  results if the resources for the default cannot be
123b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  found or cannot be loaded
124b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @internal
125b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
126b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    DateFormatSymbols(const char *type, UErrorCode& status);
127b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
128b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
129b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Construct a DateFormatSymbols object by loading format data from
130b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * resources for the given locale, in the default calendar (Gregorian).
131b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
132b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param locale    Locale to load format data from.
133b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param type      Type of calendar (as returned by Calendar::getType).
134b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  Will be used to access the correct set of strings.
135b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  (NULL or empty string defaults to "gregorian".)
136b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param status    Status code.  Failure
137b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  results if the resources for the locale cannot be
138b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                  found or cannot be loaded
139b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @internal
140b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
141b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    DateFormatSymbols(const Locale& locale,
142b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru                      const char *type,
143b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru                      UErrorCode& status);
144103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius#endif  /* U_HIDE_INTERNAL_API */
145b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
146b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
147b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Copy constructor.
148b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
149b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
150b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    DateFormatSymbols(const DateFormatSymbols&);
151b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
152b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
153b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Assignment operator.
154b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
155b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
156b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    DateFormatSymbols& operator=(const DateFormatSymbols&);
157b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
158b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
159b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Destructor. This is nonvirtual because this class is not designed to be
160b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * subclassed.
161b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
162b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
163b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    virtual ~DateFormatSymbols();
164b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
165b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
166b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Return true if another object is semantically equal to this one.
167b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
168b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param other    the DateFormatSymbols object to be compared with.
169b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return         true if other is semantically equal to this.
170b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
171b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
172b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UBool operator==(const DateFormatSymbols& other) const;
173b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
174b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
175b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Return true if another object is semantically unequal to this one.
176b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
177b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param other    the DateFormatSymbols object to be compared with.
178b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return         true if other is semantically unequal to this.
179b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
180b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
181b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UBool operator!=(const DateFormatSymbols& other) const { return !operator==(other); }
182b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
183b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
184b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     * Gets abbreviated era strings. For example: "AD" and "BC".
185b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
186b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count    Filled in with length of the array.
187b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return         the era strings.
188b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
189b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
190b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getEras(int32_t& count) const;
191b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
192b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
193b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     * Sets abbreviated era strings. For example: "AD" and "BC".
194b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param eras  Array of era strings (DateFormatSymbols retains ownership.)
195b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count Filled in with length of the array.
196b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
197b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
198b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setEras(const UnicodeString* eras, int32_t count);
199b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
200b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
201b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Gets era name strings. For example: "Anno Domini" and "Before Christ".
202b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
203b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count    Filled in with length of the array.
204b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return         the era name strings.
205b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.4
206b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
207b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getEraNames(int32_t& count) const;
208b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
209b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
210b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Sets era name strings. For example: "Anno Domini" and "Before Christ".
211b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param eraNames  Array of era name strings (DateFormatSymbols retains ownership.)
212b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count Filled in with length of the array.
213b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.6
214b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
215b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setEraNames(const UnicodeString* eraNames, int32_t count);
216b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
217b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
21850294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * Gets narrow era strings. For example: "A" and "B".
219b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     *
220b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     * @param count    Filled in with length of the array.
221b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     * @return         the narrow era strings.
22250294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * @stable ICU 4.2
223b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     */
224b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru    const UnicodeString* getNarrowEras(int32_t& count) const;
225b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru
226b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru    /**
227b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     * Sets narrow era strings. For example: "A" and "B".
228b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     * @param narrowEras  Array of narrow era strings (DateFormatSymbols retains ownership.)
229b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     * @param count Filled in with length of the array.
23050294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * @stable ICU 4.2
231b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     */
232b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru    void setNarrowEras(const UnicodeString* narrowEras, int32_t count);
233b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru
234b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru    /**
235b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Gets month strings. For example: "January", "February", etc.
236b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count Filled in with length of the array.
237b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return the month strings. (DateFormatSymbols retains ownership.)
238b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
239b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
240b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getMonths(int32_t& count) const;
241b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
242b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
243b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Sets month strings. For example: "January", "February", etc.
244b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
245b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param months    the new month strings. (not adopted; caller retains ownership)
246b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count     Filled in with length of the array.
247b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
248b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
249b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setMonths(const UnicodeString* months, int32_t count);
250b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
251b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
252b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Gets short month strings. For example: "Jan", "Feb", etc.
253b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
254b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count Filled in with length of the array.
255b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return the short month strings. (DateFormatSymbols retains ownership.)
256b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
257b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
258b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getShortMonths(int32_t& count) const;
259b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
260b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
261b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Sets short month strings. For example: "Jan", "Feb", etc.
262b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count        Filled in with length of the array.
263b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param shortMonths  the new short month strings. (not adopted; caller retains ownership)
264b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
265b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
266b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setShortMonths(const UnicodeString* shortMonths, int32_t count);
267b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
268b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
269b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Selector for date formatting context
270b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.6
271b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
272b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    enum DtContextType {
273b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru         FORMAT,
274b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru         STANDALONE,
275b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru         DT_CONTEXT_COUNT
276b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    };
277b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
278b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
279b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Selector for date formatting width
280b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.6
281b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
282b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    enum DtWidthType {
283b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru         ABBREVIATED,
284b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru         WIDE,
285b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru         NARROW,
2868393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius         /**
2878393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius          * Short width is currently only supported for weekday names.
288fceb39872958b9fa2505e63f8b8699a9e0f882f4ccornelius          * @stable ICU 51
2898393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius          */
2908393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius         SHORT,
2918393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius         /**
2928393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius          */
2938393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius         DT_WIDTH_COUNT = 4
294b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    };
295b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
296b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
297b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Gets month strings by width and context. For example: "January", "February", etc.
298b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count Filled in with length of the array.
299b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param context The formatting context, either FORMAT or STANDALONE
300b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param width   The width of returned strings, either WIDE, ABBREVIATED, or NARROW.
301b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return the month strings. (DateFormatSymbols retains ownership.)
302b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.4
303b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
304b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getMonths(int32_t& count, DtContextType context, DtWidthType width) const;
305b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
306b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
307b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Sets month strings by width and context. For example: "January", "February", etc.
308b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
309b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param months  The new month strings. (not adopted; caller retains ownership)
310b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count   Filled in with length of the array.
311b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param context The formatting context, either FORMAT or STANDALONE
312b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param width   The width of returned strings, either WIDE, ABBREVIATED, or NARROW.
313b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.6
314b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
315b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setMonths(const UnicodeString* months, int32_t count, DtContextType context, DtWidthType width);
316b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
317b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
3188393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * Gets wide weekday strings. For example: "Sunday", "Monday", etc.
319b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count        Filled in with length of the array.
320b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return the weekday strings. (DateFormatSymbols retains ownership.)
321b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
322b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
323b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getWeekdays(int32_t& count) const;
324b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
325b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
326b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
3278393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * Sets wide weekday strings. For example: "Sunday", "Monday", etc.
328b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param weekdays     the new weekday strings. (not adopted; caller retains ownership)
329b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count        Filled in with length of the array.
330b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
331b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
332b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setWeekdays(const UnicodeString* weekdays, int32_t count);
333b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
334b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
3358393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * Gets abbreviated weekday strings. For example: "Sun", "Mon", etc. (Note: The method name is
3368393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * misleading; it does not get the CLDR-style "short" weekday strings, e.g. "Su", "Mo", etc.)
337b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count        Filled in with length of the array.
3388393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * @return             the abbreviated weekday strings. (DateFormatSymbols retains ownership.)
339b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
340b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
341b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getShortWeekdays(int32_t& count) const;
342b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
343b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
3448393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * Sets abbreviated weekday strings. For example: "Sun", "Mon", etc. (Note: The method name is
3458393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * misleading; it does not set the CLDR-style "short" weekday strings, e.g. "Su", "Mo", etc.)
3468393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * @param abbrevWeekdays  the new abbreviated weekday strings. (not adopted; caller retains ownership)
3478393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * @param count           Filled in with length of the array.
348b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
349b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
3508393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius    void setShortWeekdays(const UnicodeString* abbrevWeekdays, int32_t count);
351b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
352b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
353b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Gets weekday strings by width and context. For example: "Sunday", "Monday", etc.
354b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count   Filled in with length of the array.
355b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param context The formatting context, either FORMAT or STANDALONE
3568393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * @param width   The width of returned strings, either WIDE, ABBREVIATED, SHORT, or NARROW
357b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return the month strings. (DateFormatSymbols retains ownership.)
358b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.4
359b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
360b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getWeekdays(int32_t& count, DtContextType context, DtWidthType width) const;
361b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
362b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
363b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Sets weekday strings by width and context. For example: "Sunday", "Monday", etc.
364b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param weekdays  The new weekday strings. (not adopted; caller retains ownership)
365b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count     Filled in with length of the array.
366b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param context   The formatting context, either FORMAT or STANDALONE
3678393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * @param width     The width of returned strings, either WIDE, ABBREVIATED, SHORT, or NARROW
368b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.6
369b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
370b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setWeekdays(const UnicodeString* weekdays, int32_t count, DtContextType context, DtWidthType width);
371b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
372b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
373b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Gets quarter strings by width and context. For example: "1st Quarter", "2nd Quarter", etc.
374b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count Filled in with length of the array.
375b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param context The formatting context, either FORMAT or STANDALONE
376b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param width   The width of returned strings, either WIDE or ABBREVIATED. There
377b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                are no NARROW quarters.
378b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return the quarter strings. (DateFormatSymbols retains ownership.)
379b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.6
380b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
381b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getQuarters(int32_t& count, DtContextType context, DtWidthType width) const;
382b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
383b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
384b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Sets quarter strings by width and context. For example: "1st Quarter", "2nd Quarter", etc.
385b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
386b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param quarters  The new quarter strings. (not adopted; caller retains ownership)
387b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count   Filled in with length of the array.
388b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param context The formatting context, either FORMAT or STANDALONE
389b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param width   The width of returned strings, either WIDE or ABBREVIATED. There
390b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                are no NARROW quarters.
391b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 3.6
392b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
393b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setQuarters(const UnicodeString* quarters, int32_t count, DtContextType context, DtWidthType width);
394b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
395b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
396b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Gets AM/PM strings. For example: "AM" and "PM".
397b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count        Filled in with length of the array.
398b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return             the weekday strings. (DateFormatSymbols retains ownership.)
399b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
400b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
401b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString* getAmPmStrings(int32_t& count) const;
402b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
403b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
404b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Sets ampm strings. For example: "AM" and "PM".
405b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param ampms        the new ampm strings. (not adopted; caller retains ownership)
406b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count        Filled in with length of the array.
407b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
408b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
409b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setAmPmStrings(const UnicodeString* ampms, int32_t count);
410b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
4111b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert#ifndef U_HIDE_INTERNAL_API
4121b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    /**
4131b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * This default time separator is used for formatting when the locale
4141b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * doesn't specify any time separator, and always recognized when parsing.
4151b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @internal
4161b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     */
4171b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    static const UChar DEFAULT_TIME_SEPARATOR = 0x003a;  // ':'
4181b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert
4191b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    /**
4201b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * This alternate time separator is always recognized when parsing.
4211b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @internal
4221b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     */
4231b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    static const UChar ALTERNATE_TIME_SEPARATOR = 0x002e;  // '.'
4241b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert#endif  /* U_HIDE_INTERNAL_API */
4251b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert
4261b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert#ifndef U_HIDE_DRAFT_API
4271b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    /**
4281b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * Gets the time separator string. For example: ":".
4291b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @param result Output param which will receive the time separator string.
4301b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @return       A reference to 'result'.
4311b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @draft ICU 55
4321b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     */
4331b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    UnicodeString& getTimeSeparatorString(UnicodeString& result) const;
4341b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert
4351b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    /**
4361b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * Sets the time separator string. For example: ":".
4371b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @param newTimeSeparator the new time separator string.
4381b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @draft ICU 55
4391b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     */
4401b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    void setTimeSeparatorString(const UnicodeString& newTimeSeparator);
4411b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert#endif  /* U_HIDE_DRAFT_API */
4421b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert
443f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius#ifndef U_HIDE_DRAFT_API
444f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    /**
445f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * Gets cyclic year name strings if the calendar has them, by width and context.
446f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * For example: "jia-zi", "yi-chou", etc.
447f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param count     Filled in with length of the array.
448f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param context   The usage context: FORMAT, STANDALONE.
449f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param width     The requested name width: WIDE, ABBREVIATED, NARROW.
450f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @return          The year name strings (DateFormatSymbols retains ownership),
451f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     *                  or null if they are not available for this calendar.
452f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @draft ICU 54
453f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     */
454f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    const UnicodeString* getYearNames(int32_t& count,
455f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius                            DtContextType context, DtWidthType width) const;
456f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius
457f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    /**
458f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * Sets cyclic year name strings by width and context. For example: "jia-zi", "yi-chou", etc.
459f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     *
460f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param yearNames The new cyclic year name strings (not adopted; caller retains ownership).
461f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param count     The length of the array.
462f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param context   The usage context: FORMAT, STANDALONE (currently only FORMAT is supported).
463f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param width     The name width: WIDE, ABBREVIATED, NARROW (currently only ABBREVIATED is supported).
464f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @draft ICU 54
465f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     */
466f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    void setYearNames(const UnicodeString* yearNames, int32_t count,
467f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius                            DtContextType context, DtWidthType width);
468f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius
469f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    /**
470f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * Gets calendar zodiac name strings if the calendar has them, by width and context.
471f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * For example: "Rat", "Ox", "Tiger", etc.
472f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param count     Filled in with length of the array.
473f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param context   The usage context: FORMAT, STANDALONE.
474f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param width     The requested name width: WIDE, ABBREVIATED, NARROW.
475f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @return          The zodiac name strings (DateFormatSymbols retains ownership),
476f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     *                  or null if they are not available for this calendar.
477f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @draft ICU 54
478f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     */
479f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    const UnicodeString* getZodiacNames(int32_t& count,
480f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius                            DtContextType context, DtWidthType width) const;
481f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius
482f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    /**
483f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * Sets calendar zodiac name strings by width and context. For example: "Rat", "Ox", "Tiger", etc.
484f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     *
485f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param zodiacNames The new zodiac name strings (not adopted; caller retains ownership).
486f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param count     The length of the array.
487f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param context   The usage context: FORMAT, STANDALONE (currently only FORMAT is supported).
488f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @param width     The name width: WIDE, ABBREVIATED, NARROW (currently only ABBREVIATED is supported).
489f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * @draft ICU 54
490f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     */
491f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    void setZodiacNames(const UnicodeString* zodiacNames, int32_t count,
492f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius                            DtContextType context, DtWidthType width);
493f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius
494f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius#endif  /* U_HIDE_DRAFT_API */
495f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius
496103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius#ifndef U_HIDE_INTERNAL_API
497103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    /**
498103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * Somewhat temporary constants for leap month pattern types, adequate for supporting
499103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * just leap month patterns as needed for Chinese lunar calendar.
500103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * Eventually we will add full support for different month pattern types (needed for
501103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * other calendars such as Hindu) at which point this approach will be replaced by a
502103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * more complete approach.
503103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * @internal
504103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     */
505103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    enum EMonthPatternType
506103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    {
507103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kLeapMonthPatternFormatWide,
508103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kLeapMonthPatternFormatAbbrev,
509103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kLeapMonthPatternFormatNarrow,
510103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kLeapMonthPatternStandaloneWide,
511103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kLeapMonthPatternStandaloneAbbrev,
512103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kLeapMonthPatternStandaloneNarrow,
513103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kLeapMonthPatternNumeric,
514103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kMonthPatternsCount
515103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    };
516103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius
517103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    /**
518103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * Somewhat temporary function for getting complete set of leap month patterns for all
519103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * contexts & widths, indexed by EMonthPatternType values. Returns NULL if calendar
520103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * does not have leap month patterns. Note, there is currently no setter for this.
521103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * Eventually we will add full support for different month pattern types (needed for
522103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * other calendars such as Hindu) at which point this approach will be replaced by a
523103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * more complete approach.
524103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * @param count        Filled in with length of the array (may be 0).
525103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * @return             The leap month patterns (DateFormatSymbols retains ownership).
526103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     *                     May be NULL if there are no leap month patterns for this calendar.
527103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * @internal
528103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     */
529103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    const UnicodeString* getLeapMonthPatterns(int32_t& count) const;
530103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius
531103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius#endif  /* U_HIDE_INTERNAL_API */
532103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius
533103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius#ifndef U_HIDE_DEPRECATED_API
534b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
535b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Gets timezone strings. These strings are stored in a 2-dimensional array.
536b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param rowCount      Output param to receive number of rows.
537b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param columnCount   Output param to receive number of columns.
538b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return              The timezone strings as a 2-d array. (DateFormatSymbols retains ownership.)
539b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @deprecated ICU 3.6
540b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
541b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    const UnicodeString** getZoneStrings(int32_t& rowCount, int32_t& columnCount) const;
542103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius#endif  /* U_HIDE_DEPRECATED_API */
543b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
544b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
545b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Sets timezone strings. These strings are stored in a 2-dimensional array.
546b26ce3a7367e4ed2ee7ddddcdc3f3d3377a455c2claireho     * <p><b>Note:</b> SimpleDateFormat no longer use the zone strings stored in
547b26ce3a7367e4ed2ee7ddddcdc3f3d3377a455c2claireho     * a DateFormatSymbols. Therefore, the time zone strings set by this mthod
548b26ce3a7367e4ed2ee7ddddcdc3f3d3377a455c2claireho     * have no effects in an instance of SimpleDateFormat for formatting time
549b26ce3a7367e4ed2ee7ddddcdc3f3d3377a455c2claireho     * zones.
550b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param strings       The timezone strings as a 2-d array to be copied. (not adopted; caller retains ownership)
551b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param rowCount      The number of rows (count of first index).
552b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param columnCount   The number of columns (count of second index).
553b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
554b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
555b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setZoneStrings(const UnicodeString* const* strings, int32_t rowCount, int32_t columnCount);
556b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
557b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
558b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Get the non-localized date-time pattern characters.
559b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return    the non-localized date-time pattern characters
560b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
561b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
562b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    static const UChar * U_EXPORT2 getPatternUChars(void);
563b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
564b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
565b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Gets localized date-time pattern characters. For example: 'u', 't', etc.
566b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * <p>
567b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Note: ICU no longer provides localized date-time pattern characters for a locale
568b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * starting ICU 3.8.  This method returns the non-localized date-time pattern
569b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * characters unless user defined localized data is set by setLocalPatternChars.
570b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param result    Output param which will receive the localized date-time pattern characters.
571b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return          A reference to 'result'.
572b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
573b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
574b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString& getLocalPatternChars(UnicodeString& result) const;
575b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
576b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
577b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Sets localized date-time pattern characters. For example: 'u', 't', etc.
578b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param newLocalPatternChars the new localized date-time
579b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * pattern characters.
580b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.0
581b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
582b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void setLocalPatternChars(const UnicodeString& newLocalPatternChars);
583b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
584b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
585b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Returns the locale for this object. Two flavors are available:
586b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * valid and actual locale.
587b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.8
588b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
589b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const;
590b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
591fceb39872958b9fa2505e63f8b8699a9e0f882f4ccornelius    /* The following type and kCapContextUsageTypeCount cannot be #ifndef U_HIDE_INTERNAL_API,
592fceb39872958b9fa2505e63f8b8699a9e0f882f4ccornelius       they are needed for .h file declarations. */
593103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    /**
594103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * Constants for capitalization context usage types.
595103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * @internal
596103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     */
597103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    enum ECapitalizationContextUsageType
598103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    {
599fceb39872958b9fa2505e63f8b8699a9e0f882f4ccornelius#ifndef U_HIDE_INTERNAL_API
600fceb39872958b9fa2505e63f8b8699a9e0f882f4ccornelius        kCapContextUsageOther = 0,
601103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageMonthFormat,     /* except narrow */
602103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageMonthStandalone, /* except narrow */
603103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageMonthNarrow,
604103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageDayFormat,     /* except narrow */
605103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageDayStandalone, /* except narrow */
606103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageDayNarrow,
607103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageEraWide,
608103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageEraAbbrev,
609103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageEraNarrow,
610103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageZoneLong,
611103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageZoneShort,
612103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageMetazoneLong,
613103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius        kCapContextUsageMetazoneShort,
614fceb39872958b9fa2505e63f8b8699a9e0f882f4ccornelius#endif /* U_HIDE_INTERNAL_API */
615fceb39872958b9fa2505e63f8b8699a9e0f882f4ccornelius        kCapContextUsageTypeCount = 14
616103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    };
617103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius
618b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
619b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * ICU "poor man's RTTI", returns a UClassID for the actual class.
620b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
621b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.2
622b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
623b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    virtual UClassID getDynamicClassID() const;
624b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
625b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
626b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * ICU "poor man's RTTI", returns a UClassID for this class.
627b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
628b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @stable ICU 2.2
629b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
630b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    static UClassID U_EXPORT2 getStaticClassID();
631b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
632b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queruprivate:
633b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
634b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    friend class SimpleDateFormat;
635b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    friend class DateFormatSymbolsSingleSetter; // see udat.cpp
636b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
637b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
638b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     * Abbreviated era strings. For example: "AD" and "BC".
639b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
640b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fEras;
641b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fErasCount;
642b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
643b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
644b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Era name strings. For example: "Anno Domini" and "Before Christ".
645b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
646b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fEraNames;
647b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fEraNamesCount;
648b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru
649b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru    /**
650b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     * Narrow era strings. For example: "A" and "B".
651b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru     */
652b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru    UnicodeString*  fNarrowEras;
653b0ac937921a2c196d8b9da665135bf6ba01a1ccfJean-Baptiste Queru    int32_t         fNarrowErasCount;
654b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
655b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
656b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Month strings. For example: "January", "February", etc.
657b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
658b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fMonths;
659b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fMonthsCount;
660b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
661b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
662b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Short month strings. For example: "Jan", "Feb", etc.
663b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
664b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fShortMonths;
665b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fShortMonthsCount;
666b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
667b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
668b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Narrow month strings. For example: "J", "F", etc.
669b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
670b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fNarrowMonths;
671b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fNarrowMonthsCount;
672b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
673b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
674b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Standalone Month strings. For example: "January", "February", etc.
675b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
676b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fStandaloneMonths;
677b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fStandaloneMonthsCount;
678b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
679b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
680b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Standalone Short month strings. For example: "Jan", "Feb", etc.
681b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
682b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fStandaloneShortMonths;
683b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fStandaloneShortMonthsCount;
684b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
685b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
686b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Standalone Narrow month strings. For example: "J", "F", etc.
687b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
688b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fStandaloneNarrowMonths;
689b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fStandaloneNarrowMonthsCount;
690b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
691b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
6928393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * CLDR-style format wide weekday strings. For example: "Sunday", "Monday", etc.
693b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
694b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fWeekdays;
695b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fWeekdaysCount;
696b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
697b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
6988393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * CLDR-style format abbreviated (not short) weekday strings. For example: "Sun", "Mon", etc.
699b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
700b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fShortWeekdays;
701b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fShortWeekdaysCount;
702b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
703b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
7048393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * CLDR-style format short weekday strings. For example: "Su", "Mo", etc.
7058393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     */
7068393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius    UnicodeString*  fShorterWeekdays;
7078393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius    int32_t         fShorterWeekdaysCount;
7088393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius
7098393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius    /**
7108393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * CLDR-style format narrow weekday strings. For example: "S", "M", etc.
711b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
712b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fNarrowWeekdays;
713b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fNarrowWeekdaysCount;
714b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
715b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
7168393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * CLDR-style standalone wide weekday strings. For example: "Sunday", "Monday", etc.
717b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
718b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fStandaloneWeekdays;
719b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fStandaloneWeekdaysCount;
720b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
721b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
7228393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * CLDR-style standalone abbreviated (not short) weekday strings. For example: "Sun", "Mon", etc.
723b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
724b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fStandaloneShortWeekdays;
725b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fStandaloneShortWeekdaysCount;
726b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
727b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
7288393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     * CLDR-style standalone short weekday strings. For example: "Su", "Mo", etc.
7298393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius     */
7308393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius    UnicodeString*  fStandaloneShorterWeekdays;
7318393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius    int32_t         fStandaloneShorterWeekdaysCount;
7328393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius
7338393335b955da7340c9f19b1b4b2d6c0c2c04be7Craig Cornelius    /**
734b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Standalone Narrow weekday strings. For example: "Sun", "Mon", etc.
735b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
736b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fStandaloneNarrowWeekdays;
737b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fStandaloneNarrowWeekdaysCount;
738b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
739b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
740b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Ampm strings. For example: "AM" and "PM".
741b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
742b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString*  fAmPms;
743b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fAmPmsCount;
744b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
745b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
7461b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * Narrow Ampm strings. For example: "a" and "p".
7471b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     */
7481b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    UnicodeString*  fNarrowAmPms;
7491b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    int32_t         fNarrowAmPmsCount;
7501b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert
7511b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    /**
7521b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * Time separator string. For example: ":".
7531b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     */
7541b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    UnicodeString   fTimeSeparator;
7551b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert
7561b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    /**
757b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Quarter strings. For example: "1st quarter", "2nd quarter", etc.
758b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
759b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString  *fQuarters;
760b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fQuartersCount;
761b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
762b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
763b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Short quarters. For example: "Q1", "Q2", etc.
764b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
765b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString  *fShortQuarters;
766b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fShortQuartersCount;
767b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
768b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
769b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Standalone quarter strings. For example: "1st quarter", "2nd quarter", etc.
770b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
771b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString  *fStandaloneQuarters;
772b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fStandaloneQuartersCount;
773b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
774b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
775b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Standalone short quarter strings. For example: "Q1", "Q2", etc.
776b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
777b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString  *fStandaloneShortQuarters;
778b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fStandaloneShortQuartersCount;
779b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
780b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
781103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * All leap month patterns, for example "{0}bis".
782103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     */
783103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    UnicodeString  *fLeapMonthPatterns;
784103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    int32_t         fLeapMonthPatternsCount;
785103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius
786103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    /**
787f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * Cyclic year names, for example: "jia-zi", "yi-chou", ... "gui-hai";
788f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * currently we only have data for format/abbreviated.
789f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * For the others, just get from format/abbreviated, ignore set.
790103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     */
791f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    UnicodeString  *fShortYearNames;
792103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    int32_t         fShortYearNamesCount;
793103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius
794103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    /**
795f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * Cyclic zodiac names, for example "Rat", "Ox", "Tiger", etc.;
796f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * currently we only have data for format/abbreviated.
797f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     * For the others, just get from format/abbreviated, ignore set.
798f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius     */
799f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    UnicodeString  *fShortZodiacNames;
800f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    int32_t         fShortZodiacNamesCount;
801f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius
802f9878a236aa0d9662d8e40cafdaf2e04cd615835ccornelius    /**
80350294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * Localized names of time zones in this locale.  This is a
80450294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * two-dimensional array of strings of size n by m,
80550294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * where m is at least 5 and up to 7.  Each of the n rows is an
80650294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * entry containing the localized names for a single TimeZone.
80750294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *
80850294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * Each such row contains (with i ranging from 0..n-1):
80950294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *
81050294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * zoneStrings[i][0] - time zone ID
81150294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *  example: America/Los_Angeles
81250294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * zoneStrings[i][1] - long name of zone in standard time
81350294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *  example: Pacific Standard Time
81450294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * zoneStrings[i][2] - short name of zone in standard time
81550294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *  example: PST
81650294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * zoneStrings[i][3] - long name of zone in daylight savings time
81750294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *  example: Pacific Daylight Time
81850294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * zoneStrings[i][4] - short name of zone in daylight savings time
81950294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *  example: PDT
82050294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * zoneStrings[i][5] - location name of zone
82150294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *  example: United States (Los Angeles)
82250294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * zoneStrings[i][6] - long generic name of zone
82350294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *  example: Pacific Time
82450294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * zoneStrings[i][7] - short generic of zone
82550294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *  example: PT
82650294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *
82750294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * The zone ID is not localized; it corresponds to the ID
82850294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * value associated with a system time zone object.  All other entries
82950294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * are localized names.  If a zone does not implement daylight savings
83050294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * time, the daylight savings time names are ignored.
83150294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     *
83250294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * Note:CLDR 1.5 introduced metazone and its historical mappings.
83350294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * This simple two-dimensional array is no longer sufficient to represent
83450294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * localized names and its historic changes.  Since ICU 3.8.1, localized
83550294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * zone names extracted from ICU locale data is stored in a ZoneStringFormat
83650294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * instance.  But we still need to support the old way of customizing
83750294ead5e5d23f5bbfed76e00e6b510bd41eee1claireho     * localized zone names, so we keep this field for the purpose.
838b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
839b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString   **fZoneStrings;         // Zone string array set by setZoneStrings
840b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    UnicodeString   **fLocaleZoneStrings;   // Zone string array created by the locale
841b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fZoneStringsRowCount;
842b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    int32_t         fZoneStringsColCount;
843b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
844b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    Locale                  fZSFLocale;         // Locale used for getting ZoneStringFormat
845b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
846b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
847103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * Localized date-time pattern characters. For example: use 'u' as 'y'.
848b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
849103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius    UnicodeString   fLocalPatternChars;
850b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
851b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
852103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * Capitalization transforms. For each usage type, the first array element indicates
853103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * whether to titlecase for uiListOrMenu context, the second indicates whether to
854103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     * titlecase for stand-alone context.
855b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
856103e9ffba2cba345d0078eb8b8db33249f81840aCraig Cornelius     UBool fCapitalization[kCapContextUsageTypeCount][2];
857b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
858b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queruprivate:
859b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /** valid/actual locale information
860b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *  these are always ICU locales, so the length should not be a problem
861b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
862b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    char validLocale[ULOC_FULLNAME_CAPACITY];
863b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    char actualLocale[ULOC_FULLNAME_CAPACITY];
864b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
865b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    DateFormatSymbols(); // default constructor not implemented
866b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
867b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
868b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Called by the constructors to actually load data from the resources
869b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
870b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param locale               The locale to get symbols for.
871b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param type                 Calendar Type (as from Calendar::getType())
872b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param status               Input/output parameter, set to success or
873b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                             failure code upon return.
874b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param useLastResortData    determine if use last resort data
875b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
876b26ce3a7367e4ed2ee7ddddcdc3f3d3377a455c2claireho    void initializeData(const Locale& locale, const char *type, UErrorCode& status, UBool useLastResortData = FALSE);
877b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
878b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
879b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Copy or alias an array in another object, as appropriate.
880b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
881b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param dstArray    the copy destination array.
882b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param dstCount    fill in with the lenth of 'dstArray'.
883b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param srcArray    the source array to be copied.
884b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param srcCount    the length of items to be copied from the 'srcArray'.
885b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
886b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    static void assignArray(UnicodeString*& dstArray,
887b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru                            int32_t& dstCount,
888b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru                            const UnicodeString* srcArray,
889b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru                            int32_t srcCount);
890b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
891b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
892b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Return true if the given arrays' contents are equal, or if the arrays are
893b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * identical (pointers are equal).
894b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *
895b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param array1   one array to be compared with.
896b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param array2   another array to be compared with.
897b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param count    the length of items to be copied.
898b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @return         true if the given arrays' contents are equal, or if the arrays are
899b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     *                 identical (pointers are equal).
900b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
901b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    static UBool arrayCompare(const UnicodeString* array1,
902b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru                             const UnicodeString* array2,
903b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru                             int32_t count);
904b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
905b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
906b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Create a copy, in fZoneStrings, of the given zone strings array. The
907b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * member variables fZoneStringsRowCount and fZoneStringsColCount should be
908b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * set already by the caller.
909b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
910b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void createZoneStrings(const UnicodeString *const * otherStrings);
911b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
912b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
913b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Delete all the storage owned by this object.
914b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
915b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void dispose(void);
916b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
917b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
918b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Copy all of the other's data to this.
919b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * @param other the object to be copied.
920b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
921b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void copyData(const DateFormatSymbols& other);
922b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
923b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
924b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Create zone strings array by locale if not yet available
925b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
926b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void initZoneStringsArray(void);
927b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
928b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    /**
929b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     * Delete just the zone strings.
930b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru     */
931b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru    void disposeZoneStrings(void);
93254dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius
93354dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius    /**
93454dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius     * Returns the date format field index of the pattern character c,
93554dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius     * or UDAT_FIELD_COUNT if c is not a pattern character.
93654dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius     */
93754dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius    static UDateFormatField U_EXPORT2 getPatternCharIndex(UChar c);
93854dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius
93954dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius    /**
94054dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius     * Returns TRUE if f (with its pattern character repeated count times) is a numeric field.
94154dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius     */
94254dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius    static UBool U_EXPORT2 isNumericField(UDateFormatField f, int32_t count);
94354dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius
94454dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius    /**
94554dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius     * Returns TRUE if c (repeated count times) is the pattern character for a numeric field.
94654dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius     */
94754dcd9b6a06071f647dac967e9e267abb9410720Craig Cornelius    static UBool U_EXPORT2 isNumericPatternChar(UChar c, int32_t count);
9481b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubertpublic:
9491b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert#ifndef U_HIDE_INTERNAL_API
9501b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    /**
9511b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * Gets a DateFormatSymbols by locale.
9521b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * Unlike the constructors which always use gregorian calendar, this
9531b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * method uses the calendar in the locale. If the locale contains no
9541b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * explicit calendar, this method uses the default calendar for that
9551b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * locale.
9561b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @param locale the locale.
9571b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @param status error returned here.
9581b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @return the new DateFormatSymbols which the caller owns.
9591b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     * @internal For ICU use only.
9601b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert     */
9611b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert    static DateFormatSymbols * U_EXPORT2 createForLocale(
9621b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert            const Locale &locale, UErrorCode &status);
9631b7d32f919554dda9c193b32188251337bc756f1Fredrik Roubert#endif  /* U_HIDE_INTERNAL_API */
964b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru};
965b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
966b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste QueruU_NAMESPACE_END
967b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
968b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#endif /* #if !UCONFIG_NO_FORMATTING */
969b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru
970b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru#endif // _DTFMTSYM
971b13da9df870a61b11249bf741347908dbea0edd8Jean-Baptiste Queru//eof
972