Lines Matching full:timezone
6 * File TIMEZONE.H
34 * \brief C++ API: TimeZone object
50 * <code>TimeZone</code> represents a time zone offset, and also figures out daylight
54 * Typically, you get a <code>TimeZone</code> using <code>createDefault</code>
55 * which creates a <code>TimeZone</code> based on the time zone where the program
57 * creates a <code>TimeZone</code> object based on Japanese Standard Time.
60 * You can also get a <code>TimeZone</code> using <code>createTimeZone</code> along
62 * Time zone is "America/Los_Angeles". So, you can get a Pacific Time <code>TimeZone</code> object
66 * TimeZone *tz = TimeZone::createTimeZone("America/Los_Angeles");
72 * supported ID to get a <code>TimeZone</code>.
84 * time zone ID. The <code>TimeZone</code> that is returned
88 * time zone ID to create a TimeZone representing 14 hours ahead
93 * TimeZone is an abstract class representing a time zone. A TimeZone is needed for
94 * Calendar to produce local time for a particular time zone. A TimeZone comprises
106 * (Only the ID is actually implemented in TimeZone; subclasses of TimeZone may handle
108 * TimeZone subclasses: RuleBasedTimeZone, SimpleTimeZone, and VTimeZone.)
110 * The TimeZone class contains a static list containing a TimeZone object for every
119 * To create a new TimeZone, you call the factory function TimeZone::createTimeZone()
123 * You can also use TimeZone::createDefault() to create a TimeZone. This function uses
124 * platform-specific APIs to produce a TimeZone for the time zone corresponding to
126 * your machine is set up correctly), TimeZone::createDefault() will return a TimeZone
129 class U_I18N_API TimeZone : public UObject {
134 virtual ~TimeZone();
148 static const TimeZone& U_EXPORT2 getUnknown();
162 static const TimeZone* U_EXPORT2 getGMT(void);
165 * Creates a <code>TimeZone</code> for the given ID.
166 * @param ID the ID for a <code>TimeZone</code>, such as "America/Los_Angeles",
168 * @return the specified <code>TimeZone</code>, or a mutable clone of getUnknown()
175 static TimeZone* U_EXPORT2 createTimeZone(const UnicodeString& ID);
278 * Creates an instance of TimeZone detected from the current host
280 * time zone unless TimeZone::adoptDefault(TimeZone*) or
281 * TimeZone::setDefault(const TimeZone&) is explicitly called by a
283 * and may return a different TimeZone from the one returned by
284 * TimeZone::createDefault().
286 * @return A new instance of TimeZone detected from the current host system
290 static TimeZone* U_EXPORT2 detectHostTimeZone();
294 * Creates a new copy of the default TimeZone for this host. Unless the default time
297 * system routines fail, or if they specify a TimeZone or TimeZone offset which is not
298 * recognized, the TimeZone indicated by the ID kLastResortID is instantiated
301 * @return A default TimeZone. Clients are responsible for deleting the time zone
305 static TimeZone* U_EXPORT2 createDefault(void);
310 * zone is set to the default host time zone. This call adopts the TimeZone object
317 * @param zone A pointer to the new TimeZone object to use as the default.
320 static void U_EXPORT2 adoptDefault(TimeZone* zone);
324 * Same as adoptDefault(), except that the TimeZone object passed in is NOT adopted;
329 * @param zone The given timezone.
333 static void U_EXPORT2 setDefault(const TimeZone& zone);
337 * Returns the timezone data version currently used by ICU.
345 * Returns the canonical system timezone ID or the normalized
388 * please read the ICU user guide section <a href="http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data">
416 * please read the ICU user guide section <a href="http://userguide.icu-project.org/datetime/timezone#TOC-Updating-the-Time-Zone-Data">
433 * Returns true if the two TimeZones are equal. (The TimeZone version only compares
436 * @param that The TimeZone object to be compared with.
437 * @return True if the given TimeZone is equal to this TimeZone; false
441 virtual UBool operator==(const TimeZone& that) const;
447 * @param that The TimeZone object to be compared with.
448 * @return True if the given TimeZone is not equal to this TimeZone; false
452 UBool operator!=(const TimeZone& that) const {return !operator==(that);}
455 * Returns the TimeZone's adjusted GMT offset (i.e., the number of milliseconds to add
509 * Gregorian calendar. The default implementation in the TimeZone
532 * Sets the TimeZone's raw GMT offset (i.e., the number of milliseconds to add
541 * Returns the TimeZone's raw GMT offset (i.e., the number of milliseconds to add
544 * @return The TimeZone's raw GMT offset.
550 * Fills in "ID" with the TimeZone's ID.
552 * @param ID Receives this TimeZone's ID.
559 * Sets the TimeZone's ID to the specified value. This doesn't affect any other
562 * . TimeZone* foo = TimeZone::createTimeZone("America/New_York");
687 * ICU TimeZone uses the tz database, which supports historic
709 * <code>BasicTimeZone</code> class (Note that <code>TimeZone::createTimeZone(const UnicodeString &ID)</code>
736 * @param other the <code>TimeZone</code> object to be compared with
741 virtual UBool hasSameRules(const TimeZone& other) const;
744 * Clones TimeZone objects polymorphically. Clients are responsible for deleting
745 * the TimeZone object cloned.
747 * @return A new copy of this TimeZone object.
750 virtual TimeZone* clone(void) const = 0;
765 * Concrete subclasses of TimeZone must use the UOBJECT_DEFINE_RTTI_IMPLEMENTATION
781 * If an underlying TimeZone implementation subclass supports
816 TimeZone();
819 * Construct a TimeZone with a given ID.
823 TimeZone(const UnicodeString &id);
830 TimeZone(const TimeZone& source);
837 TimeZone& operator=(const TimeZone& right);
856 static TimeZone* createCustomTimeZone(const UnicodeString&); // Creates a time zone based on the string.
947 TimeZone::getID(UnicodeString& ID) const
956 TimeZone::setID(const UnicodeString& ID)
