1 // © 2016 and later: Unicode, Inc. and others.
2 // License & terms of use: http://www.unicode.org/copyright.html
4 *******************************************************************************
5 * Copyright (C) 2008-2014, Google, International Business Machines Corporation
6 * and others. All Rights Reserved.
7 *******************************************************************************
13 #include "unicode/utypes.h"
17 * \brief C++ API: Format and parse duration in single time unit
21 #if U_SHOW_CPLUSPLUS_API
23 #if !UCONFIG_NO_FORMATTING
25 #include "unicode/unistr.h"
26 #include "unicode/tmunit.h"
27 #include "unicode/tmutamt.h"
28 #include "unicode/measfmt.h"
29 #include "unicode/numfmt.h"
30 #include "unicode/plurrule.h"
32 #ifndef U_HIDE_DEPRECATED_API
35 * Constants for various styles.
36 * There are 2 styles: full name and abbreviated name.
37 * For example, for English, the full name for hour duration is "3 hours",
38 * and the abbreviated name is "3 hrs".
39 * @deprecated ICU 53 Use MeasureFormat and UMeasureFormatWidth instead.
41 enum UTimeUnitFormatStyle {
42 /** @deprecated ICU 53 */
44 /** @deprecated ICU 53 */
45 UTMUTFMT_ABBREVIATED_STYLE,
46 /** @deprecated ICU 53 */
47 UTMUTFMT_FORMAT_STYLE_COUNT
49 typedef enum UTimeUnitFormatStyle UTimeUnitFormatStyle; /**< @deprecated ICU 53 */
57 struct TimeUnitFormatReadSink;
60 * Format or parse a TimeUnitAmount, using plural rules for the units where available.
65 * // create time unit amount instance - a combination of Number and time unit
66 * UErrorCode status = U_ZERO_ERROR;
67 * TimeUnitAmount* source = new TimeUnitAmount(2, TimeUnit::UTIMEUNIT_YEAR, status);
68 * // create time unit format instance
69 * TimeUnitFormat* format = new TimeUnitFormat(Locale("en"), status);
70 * // format a time unit amount
71 * UnicodeString formatted;
72 * Formattable formattable;
73 * if (U_SUCCESS(status)) {
74 * formattable.adoptObject(source);
75 * formatted = ((Format*)format)->format(formattable, formatted, status);
77 * ((Format*)format)->parseObject(formatted, result, status);
78 * if (U_SUCCESS(status)) {
79 * assert (result == formattable);
87 * @deprecated ICU 53 Use the MeasureFormat class instead.
89 class U_I18N_API TimeUnitFormat: public MeasureFormat {
93 * Create TimeUnitFormat with default locale, and full name style.
94 * Use setLocale and/or setFormat to modify.
97 TimeUnitFormat(UErrorCode& status);
100 * Create TimeUnitFormat given locale, and full name style.
103 TimeUnitFormat(const Locale& locale, UErrorCode& status);
106 * Create TimeUnitFormat given locale and style.
109 TimeUnitFormat(const Locale& locale, UTimeUnitFormatStyle style, UErrorCode& status);
115 TimeUnitFormat(const TimeUnitFormat&);
121 virtual ~TimeUnitFormat();
124 * Clone this Format object polymorphically. The caller owns the result and
125 * should delete it when done.
126 * @return A copy of the object.
129 virtual TimeUnitFormat* clone() const override;
132 * Assignment operator
135 TimeUnitFormat& operator=(const TimeUnitFormat& other);
138 * Set the locale used for formatting or parsing.
139 * @param locale the locale to be set
140 * @param status output param set to success/failure code on exit
143 void setLocale(const Locale& locale, UErrorCode& status);
147 * Set the number format used for formatting or parsing.
148 * @param format the number formatter to be set
149 * @param status output param set to success/failure code on exit
152 void setNumberFormat(const NumberFormat& format, UErrorCode& status);
155 * Parse a TimeUnitAmount.
156 * @see Format#parseObject(const UnicodeString&, Formattable&, ParsePosition&) const;
159 virtual void parseObject(const UnicodeString& source,
161 ParsePosition& pos) const override;
164 * Return the class ID for this class. This is useful only for comparing to
165 * a return value from getDynamicClassID(). For example:
167 * . Base* polymorphic_pointer = createPolymorphicObject();
168 * . if (polymorphic_pointer->getDynamicClassID() ==
169 * . erived::getStaticClassID()) ...
171 * @return The class ID for all objects of this class.
174 static UClassID U_EXPORT2 getStaticClassID(void);
177 * Returns a unique class ID POLYMORPHICALLY. Pure virtual override. This
178 * method is to implement a simple version of RTTI, since not all C++
179 * compilers support genuine RTTI. Polymorphic operator==() and clone()
180 * methods call this method.
182 * @return The class ID for this object. All objects of a
183 * given class have the same class ID. Objects of
184 * other classes have different class IDs.
187 virtual UClassID getDynamicClassID(void) const override;
190 Hashtable* fTimeUnitToCountToPatterns[TimeUnit::UTIMEUNIT_FIELD_COUNT];
191 UTimeUnitFormatStyle fStyle;
193 void create(UTimeUnitFormatStyle style, UErrorCode& status);
195 // it might actually be simpler to make them Decimal Formats later.
196 // initialize all private data members
197 void setup(UErrorCode& status);
199 // initialize data member without fill in data for fTimeUnitToCountToPattern
200 void initDataMembers(UErrorCode& status);
202 // initialize fTimeUnitToCountToPatterns from current locale's resource.
203 void readFromCurrentLocale(UTimeUnitFormatStyle style, const char* key, const UVector& pluralCounts,
206 // check completeness of fTimeUnitToCountToPatterns against all time units,
207 // and all plural rules, fill in fallback as necessary.
208 void checkConsistency(UTimeUnitFormatStyle style, const char* key, UErrorCode& status);
210 // fill in fTimeUnitToCountToPatterns from locale fall-back chain
211 void searchInLocaleChain(UTimeUnitFormatStyle style, const char* key, const char* localeName,
212 TimeUnit::UTimeUnitFields field, const UnicodeString&,
213 const char*, Hashtable*, UErrorCode&);
215 // initialize hash table
216 Hashtable* initHash(UErrorCode& status);
219 void deleteHash(Hashtable* htable);
222 void copyHash(const Hashtable* source, Hashtable* target, UErrorCode& status);
223 // get time unit name, such as "year", from time unit field enum, such as
225 static const char* getTimeUnitName(TimeUnit::UTimeUnitFields field, UErrorCode& status);
227 friend struct TimeUnitFormatReadSink;
232 #endif /* U_HIDE_DEPRECATED_API */
233 #endif /* #if !UCONFIG_NO_FORMATTING */
235 #endif /* U_SHOW_CPLUSPLUS_API */
237 #endif // __TMUTFMT_H__