ICU-6435 fix bad 4.0 tags. Re-do r23962 as stable 3.8 instead of stable 4.0.

X-SVN-Rev: 24395
This commit is contained in:
Steven R. Loomis 2008-07-21 18:57:26 +00:00
parent 7e4b9db07a
commit fa50d4a3b2
21 changed files with 286 additions and 286 deletions

View file

@ -136,7 +136,7 @@ ucasemap_setOptions(UCaseMap *csm, uint32_t options, UErrorCode *pErrorCode);
* @see ucasemap_toTitle
* @see ucasemap_utf8ToTitle
* @see UnicodeString::toTitle
* @stable ICU 4.0
* @stable ICU 3.8
*/
#define U_TITLECASE_NO_LOWERCASE 0x100
@ -161,7 +161,7 @@ ucasemap_setOptions(UCaseMap *csm, uint32_t options, UErrorCode *pErrorCode);
* @see ucasemap_utf8ToTitle
* @see UnicodeString::toTitle
* @see U_TITLECASE_NO_LOWERCASE
* @stable ICU 4.0
* @stable ICU 3.8
*/
#define U_TITLECASE_NO_BREAK_ADJUSTMENT 0x200
@ -174,7 +174,7 @@ ucasemap_setOptions(UCaseMap *csm, uint32_t options, UErrorCode *pErrorCode);
* Do not modify the returned break iterator.
* @param csm UCaseMap service object.
* @return titlecasing break iterator
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT const UBreakIterator * U_EXPORT2
ucasemap_getBreakIterator(const UCaseMap *csm);
@ -197,7 +197,7 @@ ucasemap_getBreakIterator(const UCaseMap *csm);
*
* @see ucasemap_toTitle
* @see ucasemap_utf8ToTitle
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT void U_EXPORT2
ucasemap_setBreakIterator(UCaseMap *csm, UBreakIterator *iterToAdopt, UErrorCode *pErrorCode);
@ -241,7 +241,7 @@ ucasemap_setBreakIterator(UCaseMap *csm, UBreakIterator *iterToAdopt, UErrorCode
* in which case it will be greater than destCapacity.
*
* @see u_strToTitle
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT int32_t U_EXPORT2
ucasemap_toTitle(UCaseMap *csm,
@ -348,7 +348,7 @@ ucasemap_utf8ToUpper(const UCaseMap *csm,
* @see u_strToTitle
* @see U_TITLECASE_NO_LOWERCASE
* @see U_TITLECASE_NO_BREAK_ADJUSTMENT
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT int32_t U_EXPORT2
ucasemap_utf8ToTitle(UCaseMap *csm,
@ -384,7 +384,7 @@ ucasemap_utf8ToTitle(UCaseMap *csm,
* @see ucasemap_setOptions
* @see U_FOLD_CASE_DEFAULT
* @see U_FOLD_CASE_EXCLUDE_SPECIAL_I
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT int32_t U_EXPORT2
ucasemap_utf8FoldCase(const UCaseMap *csm,

View file

@ -957,7 +957,7 @@ uloc_acceptLanguage(char *result, int32_t resultAvailable,
* @param status an error is returned if the LCID is unrecognized or the output buffer
* is too small
* @return actual the actual size of the locale ID, not including NUL-termination
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT int32_t U_EXPORT2
uloc_getLocaleForLCID(uint32_t hostID, char *locale, int32_t localeCapacity,

View file

@ -480,7 +480,7 @@ public:
* @return TRUE/FALSE for whether the set has been frozen
* @see freeze
* @see cloneAsThawed
* @stable ICU 4.0
* @stable ICU 3.8
*/
inline UBool isFrozen() const;
@ -495,7 +495,7 @@ public:
* @return this set.
* @see isFrozen
* @see cloneAsThawed
* @stable ICU 4.0
* @stable ICU 3.8
*/
UnicodeFunctor *freeze();
@ -505,7 +505,7 @@ public:
* @return the mutable clone
* @see freeze
* @see isFrozen
* @stable ICU 4.0
* @stable ICU 3.8
*/
UnicodeFunctor *cloneAsThawed() const;
@ -816,7 +816,7 @@ public:
* @param spanCondition specifies the containment condition
* @return the length of the initial substring according to the spanCondition;
* 0 if the start of the string does not fit the spanCondition
* @stable ICU 4.0
* @stable ICU 3.8
* @see USetSpanCondition
*/
int32_t span(const UChar *s, int32_t length, USetSpanCondition spanCondition) const;
@ -835,7 +835,7 @@ public:
* @param spanCondition specifies the containment condition
* @return the start of the trailing substring according to the spanCondition;
* the string length if the end of the string does not fit the spanCondition
* @stable ICU 4.0
* @stable ICU 3.8
* @see USetSpanCondition
*/
int32_t spanBack(const UChar *s, int32_t length, USetSpanCondition spanCondition) const;
@ -855,7 +855,7 @@ public:
* @param spanCondition specifies the containment condition
* @return the length of the initial substring according to the spanCondition;
* 0 if the start of the string does not fit the spanCondition
* @stable ICU 4.0
* @stable ICU 3.8
* @see USetSpanCondition
*/
int32_t spanUTF8(const char *s, int32_t length, USetSpanCondition spanCondition) const;
@ -874,7 +874,7 @@ public:
* @param spanCondition specifies the containment condition
* @return the start of the trailing substring according to the spanCondition;
* the string length if the end of the string does not fit the spanCondition
* @stable ICU 4.0
* @stable ICU 3.8
* @see USetSpanCondition
*/
int32_t spanBackUTF8(const char *s, int32_t length, USetSpanCondition spanCondition) const;

View file

@ -2501,7 +2501,7 @@ public:
* @see U_TITLECASE_NO_LOWERCASE
* @see U_TITLECASE_NO_BREAK_ADJUSTMENT
* @see ucasemap_open
* @stable ICU 4.0
* @stable ICU 3.8
*/
UnicodeString &toTitle(BreakIterator *titleIter, const Locale &locale, uint32_t options);

View file

@ -161,7 +161,7 @@ typedef enum UScriptCode {
USCRIPT_UNWRITTEN_LANGUAGES = 102,/* Zxxx */
USCRIPT_UNKNOWN = 103,/* Zzzz */ /* Unknown="Code for uncoded script", for unassigned code points */
/* New script codes from ISO 15924 @stable ICU 4.0 */
/* New script codes from ISO 15924 @stable ICU 3.8 */
USCRIPT_CARIAN = 104,/* Cari */
USCRIPT_JAPANESE = 105,/* Jpan */
USCRIPT_LANNA = 106,/* Lana */

View file

@ -152,7 +152,7 @@ enum {
* (strings with unpaired surrogates which cannot be converted to UTF-8)
* are ignored.
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
typedef enum USetSpanCondition {
/**
@ -164,7 +164,7 @@ typedef enum USetSpanCondition {
* it returned consists only of characters that are not in the set,
* and none of its strings overlap with the span.
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
USET_SPAN_NOT_CONTAINED = 0,
/**
@ -179,7 +179,7 @@ typedef enum USetSpanCondition {
* (There must be a single, non-overlapping concatenation of characters or strings.)
* This is equivalent to a POSIX regular expression for (OR of each set element)*.
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
USET_SPAN_CONTAINED = 1,
/**
@ -198,12 +198,12 @@ typedef enum USetSpanCondition {
* Use this span condition together with other longest-match algorithms,
* such as ICU converters (ucnv_getUnicodeSet()).
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
USET_SPAN_SIMPLE = 2,
/**
* One more than the last span condition.
* @stable ICU 4.0
* @stable ICU 3.8
*/
USET_SPAN_CONDITION_COUNT
} USetSpanCondition;
@ -300,7 +300,7 @@ uset_close(USet* set);
* @param set the original set
* @return the newly allocated copy of the set
* @see uset_cloneAsThawed
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT USet * U_EXPORT2
uset_clone(const USet *set);
@ -312,7 +312,7 @@ uset_clone(const USet *set);
* @return TRUE/FALSE for whether the set has been frozen
* @see uset_freeze
* @see uset_cloneAsThawed
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT UBool U_EXPORT2
uset_isFrozen(const USet *set);
@ -329,7 +329,7 @@ uset_isFrozen(const USet *set);
* @return the same set, now frozen
* @see uset_isFrozen
* @see uset_cloneAsThawed
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT void U_EXPORT2
uset_freeze(USet *set);
@ -342,7 +342,7 @@ uset_freeze(USet *set);
* @see uset_freeze
* @see uset_isFrozen
* @see uset_clone
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT USet * U_EXPORT2
uset_cloneAsThawed(const USet *set);
@ -855,7 +855,7 @@ uset_containsSome(const USet* set1, const USet* set2);
* @param spanCondition specifies the containment condition
* @return the length of the initial substring according to the spanCondition;
* 0 if the start of the string does not fit the spanCondition
* @stable ICU 4.0
* @stable ICU 3.8
* @see USetSpanCondition
*/
U_DRAFT int32_t U_EXPORT2
@ -876,7 +876,7 @@ uset_span(const USet *set, const UChar *s, int32_t length, USetSpanCondition spa
* @param spanCondition specifies the containment condition
* @return the start of the trailing substring according to the spanCondition;
* the string length if the end of the string does not fit the spanCondition
* @stable ICU 4.0
* @stable ICU 3.8
* @see USetSpanCondition
*/
U_DRAFT int32_t U_EXPORT2
@ -898,7 +898,7 @@ uset_spanBack(const USet *set, const UChar *s, int32_t length, USetSpanCondition
* @param spanCondition specifies the containment condition
* @return the length of the initial substring according to the spanCondition;
* 0 if the start of the string does not fit the spanCondition
* @stable ICU 4.0
* @stable ICU 3.8
* @see USetSpanCondition
*/
U_DRAFT int32_t U_EXPORT2
@ -919,7 +919,7 @@ uset_spanUTF8(const USet *set, const char *s, int32_t length, USetSpanCondition
* @param spanCondition specifies the containment condition
* @return the start of the trailing substring according to the spanCondition;
* the string length if the end of the string does not fit the spanCondition
* @stable ICU 4.0
* @stable ICU 3.8
* @see USetSpanCondition
*/
U_DRAFT int32_t U_EXPORT2

View file

@ -726,7 +726,7 @@ utext_extract(UText *ut,
* If the index is out of range, it will be pinned to be within
* the range of the input text.
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
#define UTEXT_SETNATIVEINDEX(ut, ix) \
{ int64_t __offset = (ix) - (ut)->chunkNativeStart; \

View file

@ -29,13 +29,13 @@ class UVector;
* <code>BasicTimeZone</code> is an abstract class extending <code>TimeZone</code>.
* This class provides some additional methods to access time zone transitions and rules.
* All ICU <code>TimeZone</code> concrete subclasses extend this class.
* @stable ICU 4.0
* @stable ICU 3.8
*/
class U_I18N_API BasicTimeZone: public TimeZone {
public:
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual ~BasicTimeZone();
@ -45,7 +45,7 @@ public:
* @param inclusive Whether the base time is inclusive or not.
* @param result Receives the first transition after the base time.
* @return TRUE if the transition is found.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getNextTransition(UDate base, UBool inclusive, TimeZoneTransition& result) /*const*/ = 0;
@ -55,7 +55,7 @@ public:
* @param inclusive Whether the base time is inclusive or not.
* @param result Receives the most recent transition before the base time.
* @return TRUE if the transition is found.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getPreviousTransition(UDate base, UBool inclusive, TimeZoneTransition& result) /*const*/ = 0;
@ -77,7 +77,7 @@ public:
* @param ec Output param to filled in with a success or an error.
* @return true if the other time zone has the equivalent transitions in the
* time range.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool hasEquivalentTransitions(/*const*/ BasicTimeZone& tz, UDate start, UDate end,
UBool ignoreDstAmount, UErrorCode& ec) /*const*/;
@ -88,7 +88,7 @@ public:
* <code>InitialTimeZoneRule</code>. The return value range is 0 or any positive value.
* @param status Receives error status code.
* @return The number of <code>TimeZoneRule</code>s representing time transitions.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t countTransitionRules(UErrorCode& status) /*const*/ = 0;
@ -106,7 +106,7 @@ public:
* the timezone transition rules. On output, actual number of
* rules filled in the array will be set.
* @param status Receives error status code.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual void getTimeZoneRules(const InitialTimeZoneRule*& initial,
const TimeZoneRule* trsrules[], int32_t& trscount, UErrorCode& status) /*const*/ = 0;
@ -135,7 +135,7 @@ public:
* transitions. When this time zone does not observer daylight saving times
* around the specified date, NULL is set.
* @param status Receives error status code.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual void getSimpleRulesNear(UDate date, InitialTimeZoneRule*& initial,
AnnualTimeZoneRule*& std, AnnualTimeZoneRule*& dst, UErrorCode& status) /*const*/;
@ -172,21 +172,21 @@ protected:
/**
* Default constructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
BasicTimeZone();
/**
* Construct a timezone with a given ID.
* @param id a system time zone ID
* @stable ICU 4.0
* @stable ICU 3.8
*/
BasicTimeZone(const UnicodeString &id);
/**
* Copy constructor.
* @param source the object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
BasicTimeZone(const BasicTimeZone& source);

View file

@ -209,7 +209,7 @@ public:
* Clone this object polymorphically.
* The caller owns the result and should delete it when done.
* @return a copy of the object
* @draft ICU4.0
* @draft ICU 4.0
*/
virtual DateIntervalInfo* clone(void) const;

View file

@ -43,7 +43,7 @@ class PatternMap;
* <p><i>Issue: may be useful to also have a function that returns the list of
* fields in a pattern, in order, since we have that internally.
* That would be useful for getting the UI order of field elements.</i>
* @stable ICU 4.0
* @stable ICU 3.8
**/
class U_I18N_API DateTimePatternGenerator : public UObject {
public:
@ -51,7 +51,7 @@ public:
* Construct a flexible generator according to default locale.
* @param status Output param set to success/failure code on exit,
* which must not indicate a failure before the function call.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static DateTimePatternGenerator* U_EXPORT2 createInstance(UErrorCode& status);
@ -60,7 +60,7 @@ public:
* @param uLocale
* @param status Output param set to success/failure code on exit,
* which must not indicate a failure before the function call.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static DateTimePatternGenerator* U_EXPORT2 createInstance(const Locale& uLocale, UErrorCode& status);
@ -68,20 +68,20 @@ public:
* Create an empty generator, to be constructed with addPattern(...) etc.
* @param status Output param set to success/failure code on exit,
* which must not indicate a failure before the function call.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static DateTimePatternGenerator* U_EXPORT2 createEmptyInstance(UErrorCode& status);
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual ~DateTimePatternGenerator();
/**
* Clone DateTimePatternGenerator object. Clients are responsible for
* deleting the DateTimePatternGenerator object cloned.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimePatternGenerator* clone() const;
@ -90,7 +90,7 @@ public:
*
* @param other the DateTimePatternGenerator object to be compared with.
* @return true if other is semantically equal to this.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool operator==(const DateTimePatternGenerator& other) const;
@ -99,7 +99,7 @@ public:
*
* @param other the DateTimePatternGenerator object to be compared with.
* @return true if other is semantically unequal to this.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool operator!=(const DateTimePatternGenerator& other) const;
@ -111,7 +111,7 @@ public:
* @param status Output param set to success/failure code on exit,
* which must not indicate a failure before the function call.
* @return skeleton such as "MMMdd"
* @stable ICU 4.0
* @stable ICU 3.8
*/
UnicodeString getSkeleton(const UnicodeString& pattern, UErrorCode& status);
@ -126,7 +126,7 @@ public:
* @param status Output param set to success/failure code on exit,
* which must not indicate a failure before the function call.
* @return base skeleton, such as "Md"
* @stable ICU 4.0
* @stable ICU 3.8
*/
UnicodeString getBaseSkeleton(const UnicodeString& pattern, UErrorCode& status);
@ -148,7 +148,7 @@ public:
* which must not indicate a failure before the function call.
* @return conflicting status. The value could be UDATPG_NO_CONFLICT,
* UDATPG_BASE_CONFLICT or UDATPG_CONFLICT.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UDateTimePatternConflict addPattern(const UnicodeString& pattern,
UBool override,
@ -171,7 +171,7 @@ public:
*
* @param field such as UDATPG_ERA_FIELD.
* @param value pattern, such as "{0}, {1}"
* @stable ICU 4.0
* @stable ICU 3.8
*/
void setAppendItemFormat(UDateTimePatternField field, const UnicodeString& value);
@ -181,7 +181,7 @@ public:
*
* @param field such as UDATPG_ERA_FIELD.
* @return append pattern for field
* @stable ICU 4.0
* @stable ICU 3.8
*/
const UnicodeString& getAppendItemFormat(UDateTimePatternField field) const;
@ -194,7 +194,7 @@ public:
*
* @param field such as UDATPG_ERA_FIELD.
* @param value name of the field
* @stable ICU 4.0
* @stable ICU 3.8
*/
void setAppendItemName(UDateTimePatternField field, const UnicodeString& value);
@ -204,7 +204,7 @@ public:
*
* @param field such as UDATPG_ERA_FIELD.
* @return name for field
* @stable ICU 4.0
* @stable ICU 3.8
*/
const UnicodeString& getAppendItemName(UDateTimePatternField field) const;
@ -225,14 +225,14 @@ public:
* @param dateTimeFormat
* message format pattern, here {0} will be replaced by the date
* pattern and {1} will be replaced by the time pattern.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void setDateTimeFormat(const UnicodeString& dateTimeFormat);
/**
* Getter corresponding to setDateTimeFormat.
* @return DateTimeFormat.
* @stable ICU 4.0
* @stable ICU 3.8
*/
const UnicodeString& getDateTimeFormat() const;
@ -247,7 +247,7 @@ public:
* which must not indicate a failure before the function call.
* @return bestPattern
* The best pattern found from the given skeleton.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UnicodeString getBestPattern(const UnicodeString& skeleton, UErrorCode& status);
@ -266,7 +266,7 @@ public:
* @param status Output param set to success/failure code on exit,
* which must not indicate a failure before the function call.
* @return pattern adjusted to match the skeleton fields widths and subtypes.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UnicodeString replaceFieldTypes(const UnicodeString& pattern,
const UnicodeString& skeleton,
@ -281,7 +281,7 @@ public:
* which must not indicate a failure before the function call.
* @return StringEnumeration with the skeletons.
* The caller must delete the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
StringEnumeration* getSkeletons(UErrorCode& status) const;
@ -289,7 +289,7 @@ public:
* Get the pattern corresponding to a given skeleton.
* @param skeleton
* @return pattern corresponding to a given skeleton.
* @stable ICU 4.0
* @stable ICU 3.8
*/
const UnicodeString& getPatternForSkeleton(const UnicodeString& skeleton) const;
@ -300,7 +300,7 @@ public:
* which must not indicate a failure before the function call.
* @return a StringEnumeration with the base skeletons.
* The caller must delete the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
StringEnumeration* getBaseSkeletons(UErrorCode& status) const;
@ -327,55 +327,55 @@ public:
* "H:mm:ss,SSSS"
*
* @param decimal
* @stable ICU 4.0
* @stable ICU 3.8
*/
void setDecimal(const UnicodeString& decimal);
/**
* Getter corresponding to setDecimal.
* @return UnicodeString corresponding to the decimal point
* @stable ICU 4.0
* @stable ICU 3.8
*/
const UnicodeString& getDecimal() const;
/**
* ICU "poor man's RTTI", returns a UClassID for the actual class.
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UClassID getDynamicClassID() const;
/**
* ICU "poor man's RTTI", returns a UClassID for this class.
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
static UClassID U_EXPORT2 getStaticClassID(void);
private:
/**
* Constructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimePatternGenerator(UErrorCode & status);
/**
* Constructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimePatternGenerator(const Locale& locale, UErrorCode & status);
/**
* Copy constructor.
* @param other DateTimePatternGenerator to copy
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimePatternGenerator(const DateTimePatternGenerator& other);
/**
* Default assignment operator.
* @param other DateTimePatternGenerator to copy
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimePatternGenerator& operator=(const DateTimePatternGenerator& other);

View file

@ -24,14 +24,14 @@ U_NAMESPACE_BEGIN
* a rule specified by month, day of month, day of week and
* time in the day.
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
class U_I18N_API DateTimeRule : public UObject {
public:
/**
* Date rule type constants.
* @stable ICU 4.0
* @stable ICU 3.8
*/
enum DateRuleType {
DOM = 0, /**< The exact day of month,
@ -46,7 +46,7 @@ public:
/**
* Time rule type constants.
* @stable ICU 4.0
* @stable ICU 3.8
*/
enum TimeRuleType {
WALL_TIME = 0, /**< The local wall clock time */
@ -64,7 +64,7 @@ public:
* @param millisInDay The milliseconds in the rule date.
* @param timeType The time type, <code>WALL_TIME</code> or <code>STANDARD_TIME</code>
* or <code>UTC_TIME</code>.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimeRule(int32_t month, int32_t dayOfMonth,
int32_t millisInDay, TimeRuleType timeType);
@ -82,7 +82,7 @@ public:
* @param millisInDay The milliseconds in the rule date.
* @param timeType The time type, <code>WALL_TIME</code> or <code>STANDARD_TIME</code>
* or <code>UTC_TIME</code>.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimeRule(int32_t month, int32_t weekInMonth, int32_t dayOfWeek,
int32_t millisInDay, TimeRuleType timeType);
@ -100,7 +100,7 @@ public:
* @param millisInDay The milliseconds in the rule date.
* @param timeType The time type, <code>WALL_TIME</code> or <code>STANDARD_TIME</code>
* or <code>UTC_TIME</code>.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimeRule(int32_t month, int32_t dayOfMonth, int32_t dayOfWeek, UBool after,
int32_t millisInDay, TimeRuleType timeType);
@ -108,13 +108,13 @@ public:
/**
* Copy constructor.
* @param source The DateTimeRule object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimeRule(const DateTimeRule& source);
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
~DateTimeRule();
@ -122,14 +122,14 @@ public:
* Clone this DateTimeRule object polymorphically. The caller owns the result and
* should delete it when done.
* @return A copy of the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimeRule* clone(void) const;
/**
* Assignment operator.
* @param right The object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimeRule& operator=(const DateTimeRule& right);
@ -138,7 +138,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given DateTimeRule objects are semantically equal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool operator==(const DateTimeRule& that) const;
@ -147,14 +147,14 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given DateTimeRule objects are semantically unequal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool operator!=(const DateTimeRule& that) const;
/**
* Gets the date rule type, such as <code>DOM</code>
* @return The date rule type.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateRuleType getDateRuleType(void) const;
@ -162,14 +162,14 @@ public:
* Gets the time rule type
* @return The time rule type, either <code>WALL_TIME</code> or <code>STANDARD_TIME</code>
* or <code>UTC_TIME</code>.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeRuleType getTimeRuleType(void) const;
/**
* Gets the rule month.
* @return The rule month.
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t getRuleMonth(void) const;
@ -177,7 +177,7 @@ public:
* Gets the rule day of month. When the date rule type
* is <code>DOW</code>, the value is always 0.
* @return The rule day of month
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t getRuleDayOfMonth(void) const;
@ -185,7 +185,7 @@ public:
* Gets the rule day of week. When the date rule type
* is <code>DOM</code>, the value is always 0.
* @return The rule day of week.
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t getRuleDayOfWeek(void) const;
@ -194,14 +194,14 @@ public:
* in the month. When the date rule type is not <code>DOW</code>,
* the value is always 0.
* @return The rule day of week ordinal number in the month.
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t getRuleWeekInMonth(void) const;
/**
* Gets the rule time in the rule day.
* @return The time in the rule day in milliseconds.
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t getRuleMillisInDay(void) const;
@ -224,7 +224,7 @@ public:
* . erived::getStaticClassID()) ...
* </pre>
* @return The class ID for all objects of this class.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static UClassID U_EXPORT2 getStaticClassID(void);
@ -237,7 +237,7 @@ public:
* @return The class ID for this object. All objects of a
* given class have the same class ID. Objects of
* other classes have different class IDs.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UClassID getDynamicClassID(void) const;
};

View file

@ -40,27 +40,27 @@ public:
* delete it.
* @param id The time zone ID.
* @param initialRule The initial time zone rule.
* @stable ICU 4.0
* @stable ICU 3.8
*/
RuleBasedTimeZone(const UnicodeString& id, InitialTimeZoneRule* initialRule);
/**
* Copy constructor.
* @param source The RuleBasedTimeZone object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
RuleBasedTimeZone(const RuleBasedTimeZone& source);
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual ~RuleBasedTimeZone();
/**
* Assignment operator.
* @param right The object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
RuleBasedTimeZone& operator=(const RuleBasedTimeZone& right);
@ -70,7 +70,7 @@ public:
* @param that The object to be compared with.
* @return true if the given <code>TimeZone</code> objects are
*semantically equal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator==(const TimeZone& that) const;
@ -80,7 +80,7 @@ public:
* @param that The object to be compared with.
* @return true if the given <code>TimeZone</code> objects are
* semantically unequal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator!=(const TimeZone& that) const;
@ -97,7 +97,7 @@ public:
* zone functions.
* @param rule The <code>TimeZoneRule</code>.
* @param status Output param to filled in with a success or an error.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void addTransitionRule(TimeZoneRule* rule, UErrorCode& status);
@ -108,7 +108,7 @@ public:
* builds internal structure for making the object ready to support
* time zone APIs such as getOffset(), getNextTransition() and others.
* @param status Output param to filled in with a success or an error.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void complete(UErrorCode& status);
@ -117,7 +117,7 @@ public:
* the TimeZone object cloned.
*
* @return A new copy of this TimeZone object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual TimeZone* clone(void) const;
@ -143,7 +143,7 @@ public:
* @param millis The reference date's milliseconds in day, local standard time
* @param status Output param to filled in with a success or an error.
* @return The offset in milliseconds to add to GMT to get local time.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day,
uint8_t dayOfWeek, int32_t millis, UErrorCode& status) const;
@ -165,7 +165,7 @@ public:
* @param monthLength The length of the given month in days.
* @param status Output param to filled in with a success or an error.
* @return The offset in milliseconds to add to GMT to get local time.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day,
uint8_t dayOfWeek, int32_t millis,
@ -191,7 +191,7 @@ public:
* effect, this value is zero; otherwise it is a positive value,
* typically one hour.
* @param ec input-output error code
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual void getOffset(UDate date, UBool local, int32_t& rawOffset,
int32_t& dstOffset, UErrorCode& ec) const;
@ -201,7 +201,7 @@ public:
* to GMT to get local time, before taking daylight savings time into account).
*
* @param offsetMillis The new raw GMT offset for this time zone.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual void setRawOffset(int32_t offsetMillis);
@ -210,7 +210,7 @@ public:
* to GMT to get local time, before taking daylight savings time into account).
*
* @return The TimeZone's raw GMT offset.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t getRawOffset(void) const;
@ -218,7 +218,7 @@ public:
* Queries if this time zone uses daylight savings time.
* @return true if this time zone uses daylight savings time,
* false, otherwise.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool useDaylightTime(void) const;
@ -243,7 +243,7 @@ public:
* @param other the <code>TimeZone</code> object to be compared with
* @return true if the given zone is the same as this one,
* with the possible exception of the ID
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool hasSameRules(const TimeZone& other) const;
@ -253,7 +253,7 @@ public:
* @param inclusive Whether the base time is inclusive or not.
* @param result Receives the first transition after the base time.
* @return TRUE if the transition is found.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getNextTransition(UDate base, UBool inclusive, TimeZoneTransition& result) /*const*/;
@ -263,7 +263,7 @@ public:
* @param inclusive Whether the base time is inclusive or not.
* @param result Receives the most recent transition before the base time.
* @return TRUE if the transition is found.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getPreviousTransition(UDate base, UBool inclusive, TimeZoneTransition& result) /*const*/;
@ -273,7 +273,7 @@ public:
* <code>InitialTimeZoneRule</code>. The return value range is 0 or any positive value.
* @param status Receives error status code.
* @return The number of <code>TimeZoneRule</code>s representing time transitions.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t countTransitionRules(UErrorCode& status) /*const*/;
@ -291,7 +291,7 @@ public:
* the timezone transition rules. On output, actual number of
* rules filled in the array will be set.
* @param status Receives error status code.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual void getTimeZoneRules(const InitialTimeZoneRule*& initial,
const TimeZoneRule* trsrules[], int32_t& trscount, UErrorCode& status) /*const*/;
@ -334,7 +334,7 @@ public:
* . erived::getStaticClassID()) ...
* </pre>
* @return The class ID for all objects of this class.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static UClassID U_EXPORT2 getStaticClassID(void);
@ -347,7 +347,7 @@ public:
* @return The class ID for this object. All objects of a
* given class have the same class ID. Objects of
* other classes have different class IDs.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UClassID getDynamicClassID(void) const;
};

View file

@ -707,7 +707,7 @@ public:
* @param inclusive Whether the base time is inclusive or not.
* @param result Receives the first transition after the base time.
* @return TRUE if the transition is found.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getNextTransition(UDate base, UBool inclusive, TimeZoneTransition& result) /*const*/;
@ -717,7 +717,7 @@ public:
* @param inclusive Whether the base time is inclusive or not.
* @param result Receives the most recent transition before the base time.
* @return TRUE if the transition is found.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getPreviousTransition(UDate base, UBool inclusive, TimeZoneTransition& result) /*const*/;
@ -727,7 +727,7 @@ public:
* <code>InitialTimeZoneRule</code>. The return value range is 0 or any positive value.
* @param status Receives error status code.
* @return The number of <code>TimeZoneRule</code>s representing time transitions.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t countTransitionRules(UErrorCode& status) /*const*/;
@ -745,7 +745,7 @@ public:
* the timezone transition rules. On output, actual number of
* rules filled in the array will be set.
* @param status Receives error status code.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual void getTimeZoneRules(const InitialTimeZoneRule*& initial,
const TimeZoneRule* trsrules[], int32_t& trscount, UErrorCode& status) /*const*/;

View file

@ -329,7 +329,7 @@ public:
* Returns the timezone data version currently used by ICU.
* @param status Output param to filled in with a success or an error.
* @return the version string, such as "2007f"
* @stable ICU 4.0
* @stable ICU 3.8
*/
static const char* U_EXPORT2 getTZDataVersion(UErrorCode& status);

View file

@ -27,13 +27,13 @@ U_NAMESPACE_BEGIN
* <code>TimeZoneRule</code> has a set of time zone attributes, such as zone name,
* raw offset (UTC offset for standard time) and daylight saving time offset.
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
class U_I18N_API TimeZoneRule : public UObject {
public:
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual ~TimeZoneRule();
@ -41,7 +41,7 @@ public:
* Clone this TimeZoneRule object polymorphically. The caller owns the result and
* should delete it when done.
* @return A copy of the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual TimeZoneRule* clone(void) const = 0;
@ -50,7 +50,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given <code>TimeZoneRule</code> objects are semantically equal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator==(const TimeZoneRule& that) const;
@ -59,7 +59,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given <code>TimeZoneRule</code> objects are semantically unequal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator!=(const TimeZoneRule& that) const;
@ -67,14 +67,14 @@ public:
* Fills in "name" with the name of this time zone.
* @param name Receives the name of this time zone.
* @return A reference to "name"
* @stable ICU 4.0
* @stable ICU 3.8
*/
UnicodeString& getName(UnicodeString& name) const;
/**
* Gets the standard time offset.
* @return The standard time offset from UTC in milliseconds.
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t getRawOffset(void) const;
@ -82,7 +82,7 @@ public:
* Gets the amount of daylight saving delta time from the standard time.
* @return The amount of daylight saving offset used by this rule
* in milliseconds.
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t getDSTSavings(void) const;
@ -92,7 +92,7 @@ public:
* returns true.
* @param other The <code>TimeZoneRule</code> object to be compared with.
* @return true if the other <code>TimeZoneRule</code> is the same as this one.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool isEquivalentTo(const TimeZoneRule& other) const;
@ -105,7 +105,7 @@ public:
* @param result Receives the very first time when this rule takes effect.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getFirstStart(int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const = 0;
@ -118,7 +118,7 @@ public:
* @param result Receives the final time when this rule takes effect.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getFinalStart(int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const = 0;
@ -134,7 +134,7 @@ public:
* the specified base time.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getNextStart(UDate base, int32_t prevRawOffset, int32_t prevDSTSavings,
UBool inclusive, UDate& result) const = 0;
@ -151,7 +151,7 @@ public:
* the specified base time.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getPreviousStart(UDate base, int32_t prevRawOffset, int32_t prevDSTSavings,
UBool inclusive, UDate& result) const = 0;
@ -165,21 +165,21 @@ protected:
* @param rawOffset The UTC offset of its standard time in milliseconds.
* @param dstSavings The amount of daylight saving offset adjustment in milliseconds.
* If this ia a rule for standard time, the value of this argument is 0.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeZoneRule(const UnicodeString& name, int32_t rawOffset, int32_t dstSavings);
/**
* Copy constructor.
* @param source The TimeZoneRule object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeZoneRule(const TimeZoneRule& source);
/**
* Assignment operator.
* @param right The object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeZoneRule& operator=(const TimeZoneRule& right);
@ -193,7 +193,7 @@ private:
* <code>InitialTimeZoneRule</code> represents a time zone rule
* representing a time zone effective from the beginning and
* has no actual start times.
* @stable ICU 4.0
* @stable ICU 3.8
*/
class U_I18N_API InitialTimeZoneRule : public TimeZoneRule {
public:
@ -204,20 +204,20 @@ public:
* @param rawOffset The UTC offset of its standard time in milliseconds.
* @param dstSavings The amount of daylight saving offset adjustment in milliseconds.
* If this ia a rule for standard time, the value of this argument is 0.
* @stable ICU 4.0
* @stable ICU 3.8
*/
InitialTimeZoneRule(const UnicodeString& name, int32_t rawOffset, int32_t dstSavings);
/**
* Copy constructor.
* @param source The InitialTimeZoneRule object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
InitialTimeZoneRule(const InitialTimeZoneRule& source);
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual ~InitialTimeZoneRule();
@ -225,14 +225,14 @@ public:
* Clone this InitialTimeZoneRule object polymorphically. The caller owns the result and
* should delete it when done.
* @return A copy of the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual InitialTimeZoneRule* clone(void) const;
/**
* Assignment operator.
* @param right The object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
InitialTimeZoneRule& operator=(const InitialTimeZoneRule& right);
@ -241,7 +241,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given <code>TimeZoneRule</code> objects are semantically equal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator==(const TimeZoneRule& that) const;
@ -250,7 +250,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given <code>TimeZoneRule</code> objects are semantically unequal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator!=(const TimeZoneRule& that) const;
@ -264,7 +264,7 @@ public:
* @param result Receives the start time in the year.
* @return true if this rule takes effect in the year and the result is set to
* "result".
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool getStartInYear(int32_t year, int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const;
@ -274,7 +274,7 @@ public:
* returns true.
* @param that The <code>TimeZoneRule</code> object to be compared with.
* @return true if the other <code>TimeZoneRule</code> is equivalent to this one.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool isEquivalentTo(const TimeZoneRule& that) const;
@ -287,7 +287,7 @@ public:
* @param result Receives the very first time when this rule takes effect.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getFirstStart(int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const;
@ -300,7 +300,7 @@ public:
* @param result Receives the final time when this rule takes effect.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getFinalStart(int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const;
@ -316,7 +316,7 @@ public:
* the specified base time.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getNextStart(UDate base, int32_t prevRawOffset, int32_t prevDSTSavings,
UBool inclusive, UDate& result) const;
@ -333,7 +333,7 @@ public:
* the specified base time.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getPreviousStart(UDate base, int32_t prevRawOffset, int32_t prevDSTSavings,
UBool inclusive, UDate& result) const;
@ -348,7 +348,7 @@ public:
* . erived::getStaticClassID()) ...
* </pre>
* @return The class ID for all objects of this class.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static UClassID U_EXPORT2 getStaticClassID(void);
@ -361,7 +361,7 @@ public:
* @return The class ID for this object. All objects of a
* given class have the same class ID. Objects of
* other classes have different class IDs.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UClassID getDynamicClassID(void) const;
};
@ -371,7 +371,7 @@ public:
* rule which takes effect annually. The calenday system used for the rule is
* is based on Gregorian calendar
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
class U_I18N_API AnnualTimeZoneRule : public TimeZoneRule {
public:
@ -395,7 +395,7 @@ public:
* @param startYear The first year when this rule takes effect.
* @param endYear The last year when this rule takes effect. If this
* rule is effective forever in future, specify MAX_YEAR.
* @stable ICU 4.0
* @stable ICU 3.8
*/
AnnualTimeZoneRule(const UnicodeString& name, int32_t rawOffset, int32_t dstSavings,
const DateTimeRule& dateTimeRule, int32_t startYear, int32_t endYear);
@ -414,7 +414,7 @@ public:
* @param startYear The first year when this rule takes effect.
* @param endYear The last year when this rule takes effect. If this
* rule is effective forever in future, specify MAX_YEAR.
* @stable ICU 4.0
* @stable ICU 3.8
*/
AnnualTimeZoneRule(const UnicodeString& name, int32_t rawOffset, int32_t dstSavings,
DateTimeRule* dateTimeRule, int32_t startYear, int32_t endYear);
@ -422,13 +422,13 @@ public:
/**
* Copy constructor.
* @param source The AnnualTimeZoneRule object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
AnnualTimeZoneRule(const AnnualTimeZoneRule& source);
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual ~AnnualTimeZoneRule();
@ -436,14 +436,14 @@ public:
* Clone this AnnualTimeZoneRule object polymorphically. The caller owns the result and
* should delete it when done.
* @return A copy of the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual AnnualTimeZoneRule* clone(void) const;
/**
* Assignment operator.
* @param right The object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
AnnualTimeZoneRule& operator=(const AnnualTimeZoneRule& right);
@ -452,7 +452,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given <code>TimeZoneRule</code> objects are semantically equal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator==(const TimeZoneRule& that) const;
@ -461,7 +461,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given <code>TimeZoneRule</code> objects are semantically unequal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator!=(const TimeZoneRule& that) const;
@ -469,7 +469,7 @@ public:
* Gets the start date/time rule used by this rule.
* @return The <code>AnnualDateTimeRule</code> which represents the start date/time
* rule used by this time zone rule.
* @stable ICU 4.0
* @stable ICU 3.8
*/
const DateTimeRule* getRule(void) const;
@ -477,7 +477,7 @@ public:
* Gets the first year when this rule takes effect.
* @return The start year of this rule. The year is in Gregorian calendar
* with 0 == 1 BCE, -1 == 2 BCE, etc.
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t getStartYear(void) const;
@ -485,7 +485,7 @@ public:
* Gets the end year when this rule takes effect.
* @return The end year of this rule (inclusive). The year is in Gregorian calendar
* with 0 == 1 BCE, -1 == 2 BCE, etc.
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t getEndYear(void) const;
@ -499,7 +499,7 @@ public:
* @param result Receives the start time in the year.
* @return true if this rule takes effect in the year and the result is set to
* "result".
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool getStartInYear(int32_t year, int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const;
@ -509,7 +509,7 @@ public:
* returns true.
* @param that The <code>TimeZoneRule</code> object to be compared with.
* @return true if the other <code>TimeZoneRule</code> is equivalent to this one.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool isEquivalentTo(const TimeZoneRule& that) const;
@ -522,7 +522,7 @@ public:
* @param result Receives the very first time when this rule takes effect.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getFirstStart(int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const;
@ -535,7 +535,7 @@ public:
* @param result Receives the final time when this rule takes effect.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getFinalStart(int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const;
@ -551,7 +551,7 @@ public:
* the specified base time.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getNextStart(UDate base, int32_t prevRawOffset, int32_t prevDSTSavings,
UBool inclusive, UDate& result) const;
@ -568,7 +568,7 @@ public:
* the specified base time.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getPreviousStart(UDate base, int32_t prevRawOffset, int32_t prevDSTSavings,
UBool inclusive, UDate& result) const;
@ -589,7 +589,7 @@ public:
* . erived::getStaticClassID()) ...
* </pre>
* @return The class ID for all objects of this class.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static UClassID U_EXPORT2 getStaticClassID(void);
@ -602,7 +602,7 @@ public:
* @return The class ID for this object. All objects of a
* given class have the same class ID. Objects of
* other classes have different class IDs.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UClassID getDynamicClassID(void) const;
};
@ -611,7 +611,7 @@ public:
* <code>TimeArrayTimeZoneRule</code> represents a time zone rule whose start times are
* defined by an array of milliseconds since the standard base time.
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
class U_I18N_API TimeArrayTimeZoneRule : public TimeZoneRule {
public:
@ -630,7 +630,7 @@ public:
* @param timeRuleType The time type of the start times, which is one of
* <code>DataTimeRule::WALL_TIME</code>, <code>STANDARD_TIME</code>
* and <code>UTC_TIME</code>.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeArrayTimeZoneRule(const UnicodeString& name, int32_t rawOffset, int32_t dstSavings,
const UDate* startTimes, int32_t numStartTimes, DateTimeRule::TimeRuleType timeRuleType);
@ -638,13 +638,13 @@ public:
/**
* Copy constructor.
* @param source The TimeArrayTimeZoneRule object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeArrayTimeZoneRule(const TimeArrayTimeZoneRule& source);
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual ~TimeArrayTimeZoneRule();
@ -652,14 +652,14 @@ public:
* Clone this TimeArrayTimeZoneRule object polymorphically. The caller owns the result and
* should delete it when done.
* @return A copy of the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual TimeArrayTimeZoneRule* clone(void) const;
/**
* Assignment operator.
* @param right The object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeArrayTimeZoneRule& operator=(const TimeArrayTimeZoneRule& right);
@ -668,7 +668,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given <code>TimeZoneRule</code> objects are semantically equal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator==(const TimeZoneRule& that) const;
@ -677,7 +677,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given <code>TimeZoneRule</code> objects are semantically unequal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator!=(const TimeZoneRule& that) const;
@ -687,7 +687,7 @@ public:
* or <code>UTC_TIME</code>.
*
* @return The time type used of the start times used by this rule.
* @stable ICU 4.0
* @stable ICU 3.8
*/
DateTimeRule::TimeRuleType getTimeType(void) const;
@ -698,14 +698,14 @@ public:
* @return true if the index is within the valid range and
* and the result is set. When false, the output
* parameger "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool getStartTimeAt(int32_t index, UDate& result) const;
/**
* Returns the number of start times stored in this rule
* @return The number of start times.
* @stable ICU 4.0
* @stable ICU 3.8
*/
int32_t countStartTimes(void) const;
@ -715,7 +715,7 @@ public:
* returns true.
* @param that The <code>TimeZoneRule</code> object to be compared with.
* @return true if the other <code>TimeZoneRule</code> is equivalent to this one.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool isEquivalentTo(const TimeZoneRule& that) const;
@ -728,7 +728,7 @@ public:
* @param result Receives the very first time when this rule takes effect.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getFirstStart(int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const;
@ -741,7 +741,7 @@ public:
* @param result Receives the final time when this rule takes effect.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getFinalStart(int32_t prevRawOffset, int32_t prevDSTSavings, UDate& result) const;
@ -757,7 +757,7 @@ public:
* the specified base time.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getNextStart(UDate base, int32_t prevRawOffset, int32_t prevDSTSavings,
UBool inclusive, UDate& result) const;
@ -774,7 +774,7 @@ public:
* the specified base time.
* @return true if the start time is available. When false is returned, output parameter
* "result" is unchanged.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getPreviousStart(UDate base, int32_t prevRawOffset, int32_t prevDSTSavings,
UBool inclusive, UDate& result) const;
@ -800,7 +800,7 @@ public:
* . erived::getStaticClassID()) ...
* </pre>
* @return The class ID for all objects of this class.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static UClassID U_EXPORT2 getStaticClassID(void);
@ -813,7 +813,7 @@ public:
* @return The class ID for this object. All objects of a
* given class have the same class ID. Objects of
* other classes have different class IDs.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UClassID getDynamicClassID(void) const;
};

View file

@ -26,7 +26,7 @@ class TimeZoneRule;
/**
* <code>TimeZoneTransition</code> is a class representing a time zone transition.
* An instance has a time of transition and rules for both before and after the transition.
* @stable ICU 4.0
* @stable ICU 3.8
*/
class U_I18N_API TimeZoneTransition : public UObject {
public:
@ -37,26 +37,26 @@ public:
* @param time The time of transition in milliseconds since the base time.
* @param from The time zone rule used before the transition.
* @param to The time zone rule used after the transition.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeZoneTransition(UDate time, const TimeZoneRule& from, const TimeZoneRule& to);
/**
* Constructs an empty <code>TimeZoneTransition</code>
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeZoneTransition();
/**
* Copy constructor.
* @param source The TimeZoneTransition object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeZoneTransition(const TimeZoneTransition& source);
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
~TimeZoneTransition();
@ -64,14 +64,14 @@ public:
* Clone this TimeZoneTransition object polymorphically. The caller owns the result and
* should delete it when done.
* @return A copy of the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeZoneTransition* clone(void) const;
/**
* Assignment operator.
* @param right The object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
TimeZoneTransition& operator=(const TimeZoneTransition& right);
@ -80,7 +80,7 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given TimeZoneTransition objects are semantically equal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool operator==(const TimeZoneTransition& that) const;
@ -89,28 +89,28 @@ public:
* of different subclasses are considered unequal.
* @param that The object to be compared with.
* @return true if the given TimeZoneTransition objects are semantically unequal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool operator!=(const TimeZoneTransition& that) const;
/**
* Returns the time of transition in milliseconds.
* @return The time of the transition in milliseconds since the 1970 Jan 1 epoch time.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UDate getTime(void) const;
/**
* Sets the time of transition in milliseconds.
* @param time The time of the transition in milliseconds since the 1970 Jan 1 epoch time.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void setTime(UDate time);
/**
* Returns the rule used before the transition.
* @return The time zone rule used after the transition.
* @stable ICU 4.0
* @stable ICU 3.8
*/
const TimeZoneRule* getFrom(void) const;
@ -118,7 +118,7 @@ public:
* Sets the rule used before the transition. The caller remains
* responsible for deleting the <code>TimeZoneRule</code> object.
* @param from The time zone rule used before the transition.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void setFrom(const TimeZoneRule& from);
@ -126,7 +126,7 @@ public:
* Adopts the rule used before the transition. The caller must
* not delete the <code>TimeZoneRule</code> object passed in.
* @param from The time zone rule used before the transition.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void adoptFrom(TimeZoneRule* from);
@ -134,7 +134,7 @@ public:
* Sets the rule used after the transition. The caller remains
* responsible for deleting the <code>TimeZoneRule</code> object.
* @param to The time zone rule used after the transition.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void setTo(const TimeZoneRule& to);
@ -142,14 +142,14 @@ public:
* Adopts the rule used after the transition. The caller must
* not delete the <code>TimeZoneRule</code> object passed in.
* @param to The time zone rule used after the transition.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void adoptTo(TimeZoneRule* to);
/**
* Returns the rule used after the transition.
* @return The time zone rule used after the transition.
* @stable ICU 4.0
* @stable ICU 3.8
*/
const TimeZoneRule* getTo(void) const;
@ -168,7 +168,7 @@ public:
* . erived::getStaticClassID()) ...
* </pre>
* @return The class ID for all objects of this class.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static UClassID U_EXPORT2 getStaticClassID(void);
@ -181,7 +181,7 @@ public:
* @return The class ID for this object. All objects of a
* given class have the same class ID. Objects of
* other classes have different class IDs.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UClassID getDynamicClassID(void) const;
};

View file

@ -1097,7 +1097,7 @@ ucal_getLocaleByType(const UCalendar *cal, ULocDataLocaleType type, UErrorCode*
* Returns the timezone data version currently used by ICU.
* @param status error code for the operation
* @return the version string, such as "2007f"
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT const char * U_EXPORT2
ucal_getTZDataVersion(UErrorCode* status);

View file

@ -39,7 +39,7 @@
/**
* Opaque type for a date/time pattern generator object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
typedef void *UDateTimePatternGenerator;
@ -49,57 +49,57 @@ typedef void *UDateTimePatternGenerator;
* Field number constants for udatpg_getAppendItemFormats() and similar functions.
* These constants are separate from UDateFormatField despite semantic overlap
* because some fields are merged for the date/time pattern generator.
* @stable ICU 4.0
* @stable ICU 3.8
*/
typedef enum UDateTimePatternField {
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_ERA_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_YEAR_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_QUARTER_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_MONTH_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_WEEK_OF_YEAR_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_WEEK_OF_MONTH_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_WEEKDAY_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_DAY_OF_YEAR_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_DAY_OF_WEEK_IN_MONTH_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_DAY_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_DAYPERIOD_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_HOUR_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_MINUTE_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_SECOND_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_FRACTIONAL_SECOND_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_ZONE_FIELD,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_FIELD_COUNT
} UDateTimePatternField;
/**
* Status return values from udatpg_addPattern().
* @stable ICU 4.0
* @stable ICU 3.8
*/
typedef enum UDateTimePatternConflict {
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_NO_CONFLICT,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_BASE_CONFLICT,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_CONFLICT,
/** @stable ICU 4.0 */
/** @stable ICU 3.8 */
UDATPG_CONFLICT_COUNT
} UDateTimePatternConflict;
@ -111,7 +111,7 @@ typedef enum UDateTimePatternConflict {
* @param pErrorCode a pointer to the UErrorCode which must not indicate a
* failure before the function call.
* @return a pointer to UDateTimePatternGenerator.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT UDateTimePatternGenerator * U_EXPORT2
udatpg_open(const char *locale, UErrorCode *pErrorCode);
@ -121,7 +121,7 @@ udatpg_open(const char *locale, UErrorCode *pErrorCode);
* @param pErrorCode a pointer to the UErrorCode which must not indicate a
* failure before the function call.
* @return a pointer to UDateTimePatternGenerator.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT UDateTimePatternGenerator * U_EXPORT2
udatpg_openEmpty(UErrorCode *pErrorCode);
@ -129,7 +129,7 @@ udatpg_openEmpty(UErrorCode *pErrorCode);
/**
* Close a generator.
* @param dtpg a pointer to UDateTimePatternGenerator.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT void U_EXPORT2
udatpg_close(UDateTimePatternGenerator *dtpg);
@ -140,7 +140,7 @@ udatpg_close(UDateTimePatternGenerator *dtpg);
* @param pErrorCode a pointer to the UErrorCode which must not indicate a
* failure before the function call.
* @return a pointer to a new UDateTimePatternGenerator.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT UDateTimePatternGenerator * U_EXPORT2
udatpg_clone(const UDateTimePatternGenerator *dtpg, UErrorCode *pErrorCode);
@ -166,7 +166,7 @@ udatpg_clone(const UDateTimePatternGenerator *dtpg, UErrorCode *pErrorCode);
* @param pErrorCode a pointer to the UErrorCode which must not indicate a
* failure before the function call.
* @return the length of bestPattern.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT int32_t U_EXPORT2
udatpg_getBestPattern(UDateTimePatternGenerator *dtpg,
@ -192,7 +192,7 @@ udatpg_getBestPattern(UDateTimePatternGenerator *dtpg,
* @param pErrorCode a pointer to the UErrorCode which must not indicate a
* failure before the function call.
* @return the length of skeleton.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT int32_t U_EXPORT2
udatpg_getSkeleton(UDateTimePatternGenerator *dtpg,
@ -221,7 +221,7 @@ udatpg_getSkeleton(UDateTimePatternGenerator *dtpg,
* @param pErrorCode a pointer to the UErrorCode which must not indicate a
* failure before the function call.
* @return the length of baseSkeleton.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT int32_t U_EXPORT2
udatpg_getBaseSkeleton(UDateTimePatternGenerator *dtpg,
@ -251,7 +251,7 @@ udatpg_getBaseSkeleton(UDateTimePatternGenerator *dtpg,
* failure before the function call.
* @return conflicting status. The value could be UDATPG_NO_CONFLICT,
* UDATPG_BASE_CONFLICT or UDATPG_CONFLICT.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT UDateTimePatternConflict U_EXPORT2
udatpg_addPattern(UDateTimePatternGenerator *dtpg,
@ -278,7 +278,7 @@ udatpg_addPattern(UDateTimePatternGenerator *dtpg,
* @param field UDateTimePatternField, such as UDATPG_ERA_FIELD
* @param value pattern, such as "{0}, {1}"
* @param length the length of value.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT void U_EXPORT2
udatpg_setAppendItemFormat(UDateTimePatternGenerator *dtpg,
@ -293,7 +293,7 @@ udatpg_setAppendItemFormat(UDateTimePatternGenerator *dtpg,
* @param field UDateTimePatternField, such as UDATPG_ERA_FIELD
* @param pLength A pointer that will receive the length of appendItemFormat.
* @return appendItemFormat for field.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT const UChar * U_EXPORT2
udatpg_getAppendItemFormat(const UDateTimePatternGenerator *dtpg,
@ -311,7 +311,7 @@ udatpg_getAppendItemFormat(const UDateTimePatternGenerator *dtpg,
* @param field UDateTimePatternField
* @param value name for the field.
* @param length the length of value.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT void U_EXPORT2
udatpg_setAppendItemName(UDateTimePatternGenerator *dtpg,
@ -326,7 +326,7 @@ udatpg_setAppendItemName(UDateTimePatternGenerator *dtpg,
* @param field UDateTimePatternField, such as UDATPG_ERA_FIELD
* @param pLength A pointer that will receive the length of the name for field.
* @return name for field
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT const UChar * U_EXPORT2
udatpg_getAppendItemName(const UDateTimePatternGenerator *dtpg,
@ -352,7 +352,7 @@ udatpg_getAppendItemName(const UDateTimePatternGenerator *dtpg,
* message format pattern, here {0} will be replaced by the date
* pattern and {1} will be replaced by the time pattern.
* @param length the length of dtFormat.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT void U_EXPORT2
udatpg_setDateTimeFormat(const UDateTimePatternGenerator *dtpg,
@ -363,7 +363,7 @@ udatpg_setDateTimeFormat(const UDateTimePatternGenerator *dtpg,
* @param dtpg a pointer to UDateTimePatternGenerator.
* @param pLength A pointer that will receive the length of the format
* @return dateTimeFormat.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT const UChar * U_EXPORT2
udatpg_getDateTimeFormat(const UDateTimePatternGenerator *dtpg,
@ -380,7 +380,7 @@ udatpg_getDateTimeFormat(const UDateTimePatternGenerator *dtpg,
* @param dtpg a pointer to UDateTimePatternGenerator.
* @param decimal
* @param length the length of decimal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT void U_EXPORT2
udatpg_setDecimal(UDateTimePatternGenerator *dtpg,
@ -392,7 +392,7 @@ udatpg_setDecimal(UDateTimePatternGenerator *dtpg,
* @param dtpg a pointer to UDateTimePatternGenerator.
* @param pLength A pointer that will receive the length of the decimal string.
* @return corresponding to the decimal point.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT const UChar * U_EXPORT2
udatpg_getDecimal(const UDateTimePatternGenerator *dtpg,
@ -421,7 +421,7 @@ udatpg_getDecimal(const UDateTimePatternGenerator *dtpg,
* @param pErrorCode a pointer to the UErrorCode which must not indicate a
* failure before the function call.
* @return the length of dest.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT int32_t U_EXPORT2
udatpg_replaceFieldTypes(UDateTimePatternGenerator *dtpg,
@ -439,7 +439,7 @@ udatpg_replaceFieldTypes(UDateTimePatternGenerator *dtpg,
* failure before the function call
* @return a UEnumeration list of all the skeletons
* The caller must close the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT UEnumeration * U_EXPORT2
udatpg_openSkeletons(const UDateTimePatternGenerator *dtpg, UErrorCode *pErrorCode);
@ -452,7 +452,7 @@ udatpg_openSkeletons(const UDateTimePatternGenerator *dtpg, UErrorCode *pErrorCo
* failure before the function call.
* @return a UEnumeration list of all the base skeletons
* The caller must close the object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT UEnumeration * U_EXPORT2
udatpg_openBaseSkeletons(const UDateTimePatternGenerator *dtpg, UErrorCode *pErrorCode);
@ -465,7 +465,7 @@ udatpg_openBaseSkeletons(const UDateTimePatternGenerator *dtpg, UErrorCode *pErr
* @param skeletonLength pointer to the length of skeleton.
* @param pLength pointer to the length of return pattern.
* @return pattern corresponding to a given skeleton.
* @stable ICU 4.0
* @stable ICU 3.8
*/
U_DRAFT const UChar * U_EXPORT2
udatpg_getPatternForSkeleton(const UDateTimePatternGenerator *dtpg,

View file

@ -277,7 +277,7 @@ typedef enum UDateTimeScale {
* Similar to Unix time (linear value from 1970) and struct timeval
* (microseconds resolution).
*
* @stable ICU 4.0
* @stable ICU 3.8
*/
UDTS_UNIX_MICROSECONDS_TIME,

View file

@ -34,27 +34,27 @@ class UVector;
* Note: The consumer of this class reading or writing VTIMEZONE data is responsible to
* decode or encode Non-ASCII text. Methods reading/writing VTIMEZONE data in this class
* do nothing with MIME encoding.
* @stable ICU 4.0
* @stable ICU 3.8
*/
class U_I18N_API VTimeZone : public BasicTimeZone {
public:
/**
* Copy constructor.
* @param source The <code>VTimeZone</code> object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
VTimeZone(const VTimeZone& source);
/**
* Destructor.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual ~VTimeZone();
/**
* Assignment operator.
* @param right The object to be copied.
* @stable ICU 4.0
* @stable ICU 3.8
*/
VTimeZone& operator=(const VTimeZone& right);
@ -64,7 +64,7 @@ public:
* @param that The object to be compared with.
* @return true if the given <code>TimeZone</code> objects are
*semantically equal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator==(const TimeZone& that) const;
@ -74,7 +74,7 @@ public:
* @param that The object to be compared with.
* @return true if the given <code>TimeZone</code> objects are
* semantically unequal.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool operator!=(const TimeZone& that) const;
@ -83,7 +83,7 @@ public:
* @param ID The time zone ID, such as America/New_York
* @return A <code>VTimeZone</code> object initialized by the time zone ID,
* or NULL when the ID is unknown.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static VTimeZone* createVTimeZoneByID(const UnicodeString& ID);
@ -94,7 +94,7 @@ public:
* @param status Output param to filled in with a success or an error.
* @return A <code>VTimeZone</code> initialized by the VTIMEZONE data or
* NULL if failed to load the rule from the VTIMEZONE data.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static VTimeZone* createVTimeZone(const UnicodeString& vtzdata, UErrorCode& status);
@ -104,14 +104,14 @@ public:
* in the data. Otherwise, the initial value is not set.
* @param url Receives the RFC2445 TZURL property value.
* @return TRUE if TZURL attribute is available and value is set.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool getTZURL(UnicodeString& url) const;
/**
* Sets the RFC2445 TZURL property value.
* @param url The TZURL property value.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void setTZURL(const UnicodeString& url);
@ -121,14 +121,14 @@ public:
* value in the data. Otherwise, the initial value is not set.
* @param lastModified Receives the last modified date.
* @return TRUE if lastModified attribute is available and value is set.
* @stable ICU 4.0
* @stable ICU 3.8
*/
UBool getLastModified(UDate& lastModified) const;
/**
* Sets the RFC2445 LAST-MODIFIED property value.
* @param lastModified The LAST-MODIFIED date.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void setLastModified(UDate lastModified);
@ -136,7 +136,7 @@ public:
* Writes RFC2445 VTIMEZONE data for this time zone
* @param result Output param to filled in with the VTIMEZONE data.
* @param status Output param to filled in with a success or an error.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void write(UnicodeString& result, UErrorCode& status) const;
@ -146,7 +146,7 @@ public:
* @param start The start date.
* @param result Output param to filled in with the VTIMEZONE data.
* @param status Output param to filled in with a success or an error.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void write(UDate start, UnicodeString& result, UErrorCode& status) /*const*/;
@ -161,7 +161,7 @@ public:
* @param time The date used for rule extraction.
* @param result Output param to filled in with the VTIMEZONE data.
* @param status Output param to filled in with a success or an error.
* @stable ICU 4.0
* @stable ICU 3.8
*/
void writeSimple(UDate time, UnicodeString& result, UErrorCode& status) /*const*/;
@ -169,7 +169,7 @@ public:
* Clones TimeZone objects polymorphically. Clients are responsible for deleting
* the TimeZone object cloned.
* @return A new copy of this TimeZone object.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual TimeZone* clone(void) const;
@ -195,7 +195,7 @@ public:
* @param millis The reference date's milliseconds in day, local standard time
* @param status Output param to filled in with a success or an error.
* @return The offset in milliseconds to add to GMT to get local time.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day,
uint8_t dayOfWeek, int32_t millis, UErrorCode& status) const;
@ -217,7 +217,7 @@ public:
* @param monthLength The length of the given month in days.
* @param status Output param to filled in with a success or an error.
* @return The offset in milliseconds to add to GMT to get local time.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day,
uint8_t dayOfWeek, int32_t millis,
@ -243,7 +243,7 @@ public:
* effect, this value is zero; otherwise it is a positive value,
* typically one hour.
* @param ec input-output error code
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual void getOffset(UDate date, UBool local, int32_t& rawOffset,
int32_t& dstOffset, UErrorCode& ec) const;
@ -253,7 +253,7 @@ public:
* to GMT to get local time, before taking daylight savings time into account).
*
* @param offsetMillis The new raw GMT offset for this time zone.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual void setRawOffset(int32_t offsetMillis);
@ -262,7 +262,7 @@ public:
* to GMT to get local time, before taking daylight savings time into account).
*
* @return The TimeZone's raw GMT offset.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t getRawOffset(void) const;
@ -270,7 +270,7 @@ public:
* Queries if this time zone uses daylight savings time.
* @return true if this time zone uses daylight savings time,
* false, otherwise.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool useDaylightTime(void) const;
@ -295,7 +295,7 @@ public:
* @param other the <code>TimeZone</code> object to be compared with
* @return true if the given zone is the same as this one,
* with the possible exception of the ID
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool hasSameRules(const TimeZone& other) const;
@ -305,7 +305,7 @@ public:
* @param inclusive Whether the base time is inclusive or not.
* @param result Receives the first transition after the base time.
* @return TRUE if the transition is found.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getNextTransition(UDate base, UBool inclusive, TimeZoneTransition& result) /*const*/;
@ -315,7 +315,7 @@ public:
* @param inclusive Whether the base time is inclusive or not.
* @param result Receives the most recent transition before the base time.
* @return TRUE if the transition is found.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UBool getPreviousTransition(UDate base, UBool inclusive, TimeZoneTransition& result) /*const*/;
@ -325,7 +325,7 @@ public:
* <code>InitialTimeZoneRule</code>. The return value range is 0 or any positive value.
* @param status Receives error status code.
* @return The number of <code>TimeZoneRule</code>s representing time transitions.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual int32_t countTransitionRules(UErrorCode& status) /*const*/;
@ -343,7 +343,7 @@ public:
* the timezone transition rules. On output, actual number of
* rules filled in the array will be set.
* @param status Receives error status code.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual void getTimeZoneRules(const InitialTimeZoneRule*& initial,
const TimeZoneRule* trsrules[], int32_t& trscount, UErrorCode& status) /*const*/;
@ -417,7 +417,7 @@ public:
* . erived::getStaticClassID()) ...
* </pre>
* @return The class ID for all objects of this class.
* @stable ICU 4.0
* @stable ICU 3.8
*/
static UClassID U_EXPORT2 getStaticClassID(void);
@ -430,7 +430,7 @@ public:
* @return The class ID for this object. All objects of a
* given class have the same class ID. Objects of
* other classes have different class IDs.
* @stable ICU 4.0
* @stable ICU 3.8
*/
virtual UClassID getDynamicClassID(void) const;
};

View file

@ -150,7 +150,7 @@ enum ScriptCodes {
zxxxScriptCode = 102,
zzzzScriptCode = 103,
/** New script codes from ISO 15924 @stable ICU 4.0 */
/** New script codes from ISO 15924 @stable ICU 3.8 */
cariScriptCode = 104,
jpanScriptCode = 105,
lanaScriptCode = 106,