| OLD | NEW |
| (Empty) |
| 1 /* | |
| 2 ******************************************************************************* | |
| 3 * Copyright (C) 2007-2008, International Business Machines Corporation and
* | |
| 4 * others. All Rights Reserved. * | |
| 5 ******************************************************************************* | |
| 6 */ | |
| 7 #ifndef TZTRANS_H | |
| 8 #define TZTRANS_H | |
| 9 | |
| 10 /** | |
| 11 * \file | |
| 12 * \brief C++ API: Time zone transition | |
| 13 */ | |
| 14 | |
| 15 #include "unicode/utypes.h" | |
| 16 | |
| 17 #if !UCONFIG_NO_FORMATTING | |
| 18 | |
| 19 #include "unicode/uobject.h" | |
| 20 | |
| 21 U_NAMESPACE_BEGIN | |
| 22 | |
| 23 // Forward declaration | |
| 24 class TimeZoneRule; | |
| 25 | |
| 26 /** | |
| 27 * <code>TimeZoneTransition</code> is a class representing a time zone transitio
n. | |
| 28 * An instance has a time of transition and rules for both before and after the
transition. | |
| 29 * @stable ICU 3.8 | |
| 30 */ | |
| 31 class U_I18N_API TimeZoneTransition : public UObject { | |
| 32 public: | |
| 33 /** | |
| 34 * Constructs a <code>TimeZoneTransition</code> with the time and the rules
before/after | |
| 35 * the transition. | |
| 36 * | |
| 37 * @param time The time of transition in milliseconds since the base time. | |
| 38 * @param from The time zone rule used before the transition. | |
| 39 * @param to The time zone rule used after the transition. | |
| 40 * @stable ICU 3.8 | |
| 41 */ | |
| 42 TimeZoneTransition(UDate time, const TimeZoneRule& from, const TimeZoneRule&
to); | |
| 43 | |
| 44 /** | |
| 45 * Constructs an empty <code>TimeZoneTransition</code> | |
| 46 * @stable ICU 3.8 | |
| 47 */ | |
| 48 TimeZoneTransition(); | |
| 49 | |
| 50 /** | |
| 51 * Copy constructor. | |
| 52 * @param source The TimeZoneTransition object to be copied. | |
| 53 * @stable ICU 3.8 | |
| 54 */ | |
| 55 TimeZoneTransition(const TimeZoneTransition& source); | |
| 56 | |
| 57 /** | |
| 58 * Destructor. | |
| 59 * @stable ICU 3.8 | |
| 60 */ | |
| 61 ~TimeZoneTransition(); | |
| 62 | |
| 63 /** | |
| 64 * Clone this TimeZoneTransition object polymorphically. The caller owns the
result and | |
| 65 * should delete it when done. | |
| 66 * @return A copy of the object. | |
| 67 * @stable ICU 3.8 | |
| 68 */ | |
| 69 TimeZoneTransition* clone(void) const; | |
| 70 | |
| 71 /** | |
| 72 * Assignment operator. | |
| 73 * @param right The object to be copied. | |
| 74 * @stable ICU 3.8 | |
| 75 */ | |
| 76 TimeZoneTransition& operator=(const TimeZoneTransition& right); | |
| 77 | |
| 78 /** | |
| 79 * Return true if the given TimeZoneTransition objects are semantically equa
l. Objects | |
| 80 * of different subclasses are considered unequal. | |
| 81 * @param that The object to be compared with. | |
| 82 * @return true if the given TimeZoneTransition objects are semantically eq
ual. | |
| 83 * @stable ICU 3.8 | |
| 84 */ | |
| 85 UBool operator==(const TimeZoneTransition& that) const; | |
| 86 | |
| 87 /** | |
| 88 * Return true if the given TimeZoneTransition objects are semantically uneq
ual. Objects | |
| 89 * of different subclasses are considered unequal. | |
| 90 * @param that The object to be compared with. | |
| 91 * @return true if the given TimeZoneTransition objects are semantically un
equal. | |
| 92 * @stable ICU 3.8 | |
| 93 */ | |
| 94 UBool operator!=(const TimeZoneTransition& that) const; | |
| 95 | |
| 96 /** | |
| 97 * Returns the time of transition in milliseconds. | |
| 98 * @return The time of the transition in milliseconds since the 1970 Jan 1 e
poch time. | |
| 99 * @stable ICU 3.8 | |
| 100 */ | |
| 101 UDate getTime(void) const; | |
| 102 | |
| 103 /** | |
| 104 * Sets the time of transition in milliseconds. | |
| 105 * @param time The time of the transition in milliseconds since the 1970 Jan
1 epoch time. | |
| 106 * @stable ICU 3.8 | |
| 107 */ | |
| 108 void setTime(UDate time); | |
| 109 | |
| 110 /** | |
| 111 * Returns the rule used before the transition. | |
| 112 * @return The time zone rule used after the transition. | |
| 113 * @stable ICU 3.8 | |
| 114 */ | |
| 115 const TimeZoneRule* getFrom(void) const; | |
| 116 | |
| 117 /** | |
| 118 * Sets the rule used before the transition. The caller remains | |
| 119 * responsible for deleting the <code>TimeZoneRule</code> object. | |
| 120 * @param from The time zone rule used before the transition. | |
| 121 * @stable ICU 3.8 | |
| 122 */ | |
| 123 void setFrom(const TimeZoneRule& from); | |
| 124 | |
| 125 /** | |
| 126 * Adopts the rule used before the transition. The caller must | |
| 127 * not delete the <code>TimeZoneRule</code> object passed in. | |
| 128 * @param from The time zone rule used before the transition. | |
| 129 * @stable ICU 3.8 | |
| 130 */ | |
| 131 void adoptFrom(TimeZoneRule* from); | |
| 132 | |
| 133 /** | |
| 134 * Sets the rule used after the transition. The caller remains | |
| 135 * responsible for deleting the <code>TimeZoneRule</code> object. | |
| 136 * @param to The time zone rule used after the transition. | |
| 137 * @stable ICU 3.8 | |
| 138 */ | |
| 139 void setTo(const TimeZoneRule& to); | |
| 140 | |
| 141 /** | |
| 142 * Adopts the rule used after the transition. The caller must | |
| 143 * not delete the <code>TimeZoneRule</code> object passed in. | |
| 144 * @param to The time zone rule used after the transition. | |
| 145 * @stable ICU 3.8 | |
| 146 */ | |
| 147 void adoptTo(TimeZoneRule* to); | |
| 148 | |
| 149 /** | |
| 150 * Returns the rule used after the transition. | |
| 151 * @return The time zone rule used after the transition. | |
| 152 * @stable ICU 3.8 | |
| 153 */ | |
| 154 const TimeZoneRule* getTo(void) const; | |
| 155 | |
| 156 private: | |
| 157 UDate fTime; | |
| 158 TimeZoneRule* fFrom; | |
| 159 TimeZoneRule* fTo; | |
| 160 | |
| 161 public: | |
| 162 /** | |
| 163 * Return the class ID for this class. This is useful only for comparing to | |
| 164 * a return value from getDynamicClassID(). For example: | |
| 165 * <pre> | |
| 166 * . Base* polymorphic_pointer = createPolymorphicObject(); | |
| 167 * . if (polymorphic_pointer->getDynamicClassID() == | |
| 168 * . erived::getStaticClassID()) ... | |
| 169 * </pre> | |
| 170 * @return The class ID for all objects of this class. | |
| 171 * @stable ICU 3.8 | |
| 172 */ | |
| 173 static UClassID U_EXPORT2 getStaticClassID(void); | |
| 174 | |
| 175 /** | |
| 176 * Returns a unique class ID POLYMORPHICALLY. Pure virtual override. This | |
| 177 * method is to implement a simple version of RTTI, since not all C++ | |
| 178 * compilers support genuine RTTI. Polymorphic operator==() and clone() | |
| 179 * methods call this method. | |
| 180 * | |
| 181 * @return The class ID for this object. All objects of a | |
| 182 * given class have the same class ID. Objects of | |
| 183 * other classes have different class IDs. | |
| 184 * @stable ICU 3.8 | |
| 185 */ | |
| 186 virtual UClassID getDynamicClassID(void) const; | |
| 187 }; | |
| 188 | |
| 189 U_NAMESPACE_END | |
| 190 | |
| 191 #endif /* #if !UCONFIG_NO_FORMATTING */ | |
| 192 | |
| 193 #endif // TZTRANS_H | |
| 194 | |
| 195 //eof | |
| OLD | NEW |