ICU 71.1 71.1

vtzone.h
Go to the documentation of this file.
1 // © 2016 and later: Unicode, Inc. and others.
2 // License & terms of use: http://www.unicode.org/copyright.html
3 /*
4 *******************************************************************************
5 * Copyright (C) 2007-2013, International Business Machines Corporation and
6 * others. All Rights Reserved.
7 *******************************************************************************
8 */
9 #ifndef VTZONE_H
10 #define VTZONE_H
11
12 #include "unicode/utypes.h"
13
14 #if U_SHOW_CPLUSPLUS_API
15
21 #if !UCONFIG_NO_FORMATTING
22
23 #include "unicode/basictz.h"
24
25 U_NAMESPACE_BEGIN
26
27 class VTZWriter;
28 class VTZReader;
29 class UVector;
30
45 class U_I18N_API VTimeZone : public BasicTimeZone {
46 public:
52 VTimeZone(const VTimeZone& source);
53
58 virtual ~VTimeZone();
59
65 VTimeZone& operator=(const VTimeZone& right);
66
75 virtual bool operator==(const TimeZone& that) const override;
76
85 virtual bool operator!=(const TimeZone& that) const;
86
94 static VTimeZone* createVTimeZoneByID(const UnicodeString& ID);
95
103 static VTimeZone* createVTimeZoneFromBasicTimeZone(const BasicTimeZone& basicTZ,
104 UErrorCode &status);
105
115 static VTimeZone* createVTimeZone(const UnicodeString& vtzdata, UErrorCode& status);
116
125 UBool getTZURL(UnicodeString& url) const;
126
132 void setTZURL(const UnicodeString& url);
133
142 UBool getLastModified(UDate& lastModified) const;
143
149 void setLastModified(UDate lastModified);
150
157 void write(UnicodeString& result, UErrorCode& status) const;
158
167 void write(UDate start, UnicodeString& result, UErrorCode& status) const;
168
182 void writeSimple(UDate time, UnicodeString& result, UErrorCode& status) const;
183
190 virtual VTimeZone* clone() const override;
191
216 virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day,
217 uint8_t dayOfWeek, int32_t millis, UErrorCode& status) const override;
218
238 virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day,
239 uint8_t dayOfWeek, int32_t millis,
240 int32_t monthLength, UErrorCode& status) const override;
241
264 virtual void getOffset(UDate date, UBool local, int32_t& rawOffset,
265 int32_t& dstOffset, UErrorCode& ec) const override;
266
271 virtual void getOffsetFromLocal(
272 UDate date, UTimeZoneLocalOption nonExistingTimeOpt,
273 UTimeZoneLocalOption duplicatedTimeOpt,
274 int32_t& rawOffset, int32_t& dstOffset, UErrorCode& status) const override;
275
283 virtual void setRawOffset(int32_t offsetMillis) override;
284
292 virtual int32_t getRawOffset(void) const override;
293
300 virtual UBool useDaylightTime(void) const override;
301
302 #ifndef U_FORCE_HIDE_DEPRECATED_API
303
316 virtual UBool inDaylightTime(UDate date, UErrorCode& status) const override;
317 #endif // U_FORCE_HIDE_DEPRECATED_API
318
327 virtual UBool hasSameRules(const TimeZone& other) const override;
328
337 virtual UBool getNextTransition(UDate base, UBool inclusive, TimeZoneTransition& result) const override;
338
347 virtual UBool getPreviousTransition(UDate base, UBool inclusive, TimeZoneTransition& result) const override;
348
357 virtual int32_t countTransitionRules(UErrorCode& status) const override;
358
375 virtual void getTimeZoneRules(const InitialTimeZoneRule*& initial,
376 const TimeZoneRule* trsrules[], int32_t& trscount, UErrorCode& status) const override;
377
378 private:
379 enum { DEFAULT_VTIMEZONE_LINES = 100 };
380
384 VTimeZone();
385 static VTimeZone* createVTimeZone(VTZReader* reader);
386 void write(VTZWriter& writer, UErrorCode& status) const;
387 void write(UDate start, VTZWriter& writer, UErrorCode& status) const;
388 void writeSimple(UDate time, VTZWriter& writer, UErrorCode& status) const;
389 void load(VTZReader& reader, UErrorCode& status);
390 void parse(UErrorCode& status);
391
392 void writeZone(VTZWriter& w, BasicTimeZone& basictz, UVector* customProps,
393 UErrorCode& status) const;
394
395 void writeHeaders(VTZWriter& w, UErrorCode& status) const;
396 void writeFooter(VTZWriter& writer, UErrorCode& status) const;
397
398 void writeZonePropsByTime(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
399 int32_t fromOffset, int32_t toOffset, UDate time, UBool withRDATE,
400 UErrorCode& status) const;
401 void writeZonePropsByDOM(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
402 int32_t fromOffset, int32_t toOffset,
403 int32_t month, int32_t dayOfMonth, UDate startTime, UDate untilTime,
404 UErrorCode& status) const;
405 void writeZonePropsByDOW(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
406 int32_t fromOffset, int32_t toOffset,
407 int32_t month, int32_t weekInMonth, int32_t dayOfWeek,
408 UDate startTime, UDate untilTime, UErrorCode& status) const;
409 void writeZonePropsByDOW_GEQ_DOM(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
410 int32_t fromOffset, int32_t toOffset,
411 int32_t month, int32_t dayOfMonth, int32_t dayOfWeek,
412 UDate startTime, UDate untilTime, UErrorCode& status) const;
413 void writeZonePropsByDOW_GEQ_DOM_sub(VTZWriter& writer, int32_t month, int32_t dayOfMonth,
414 int32_t dayOfWeek, int32_t numDays,
415 UDate untilTime, int32_t fromOffset, UErrorCode& status) const;
416 void writeZonePropsByDOW_LEQ_DOM(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
417 int32_t fromOffset, int32_t toOffset,
418 int32_t month, int32_t dayOfMonth, int32_t dayOfWeek,
419 UDate startTime, UDate untilTime, UErrorCode& status) const;
420 void writeFinalRule(VTZWriter& writer, UBool isDst, const AnnualTimeZoneRule* rule,
421 int32_t fromRawOffset, int32_t fromDSTSavings,
422 UDate startTime, UErrorCode& status) const;
423
424 void beginZoneProps(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
425 int32_t fromOffset, int32_t toOffset, UDate startTime, UErrorCode& status) const;
426 void endZoneProps(VTZWriter& writer, UBool isDst, UErrorCode& status) const;
427 void beginRRULE(VTZWriter& writer, int32_t month, UErrorCode& status) const;
428 void appendUNTIL(VTZWriter& writer, const UnicodeString& until, UErrorCode& status) const;
429
430 BasicTimeZone *tz;
431 UVector *vtzlines;
432 UnicodeString tzurl;
433 UDate lastmod;
434 UnicodeString olsonzid;
435 UnicodeString icutzver;
436
437 public:
449 static UClassID U_EXPORT2 getStaticClassID(void);
450
462 virtual UClassID getDynamicClassID(void) const override;
463 };
464
465 U_NAMESPACE_END
466
467 #endif /* #if !UCONFIG_NO_FORMATTING */
468
469 #endif /* U_SHOW_CPLUSPLUS_API */
470
471 #endif // VTZONE_H
472 //eof
icu::TimeZone::operator==
virtual bool operator==(const TimeZone &that) const
Returns true if the two TimeZones are equal.
utypes.h
Basic definitions for ICU, for both C and C++ APIs.
icu::VTimeZone
VTimeZone is a class implementing RFC2445 VTIMEZONE.
Definition: vtzone.h:45
icu::TimeZone::inDaylightTime
virtual UBool inDaylightTime(UDate date, UErrorCode &status) const =0
Queries if the given date is in daylight savings time in this time zone.
icu::TimeZone::operator!=
bool operator!=(const TimeZone &that) const
Returns true if the two TimeZones are NOT equal; that is, if operator==() returns false.
Definition: timezone.h:521
U_I18N_API
#define U_I18N_API
Definition: utypes.h:301
icu::TimeZone::setRawOffset
virtual void setRawOffset(int32_t offsetMillis)=0
Sets the TimeZone's raw GMT offset (i.e., the number of milliseconds to add to GMT to get local time,...
UBool
int8_t UBool
The ICU boolean type, a signed-byte integer.
Definition: umachine.h:269
icu::BasicTimeZone::clone
virtual BasicTimeZone * clone() const override=0
Clones this object polymorphically.
icu::BasicTimeZone
BasicTimeZone is an abstract class extending TimeZone.
Definition: basictz.h:38
icu::TimeZone::getDynamicClassID
virtual UClassID getDynamicClassID(void) const override=0
Returns a unique class ID POLYMORPHICALLY.
icu::TimeZoneRule
TimeZoneRule is a class representing a rule for time zone.
Definition: tzrule.h:36
icu::TimeZone
TimeZone represents a time zone offset, and also figures out daylight savings.
Definition: timezone.h:133
icu::TimeZone::getStaticClassID
static UClassID getStaticClassID(void)
Return the class ID for this class.
icu::UnicodeString
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
Definition: unistr.h:295
icu::BasicTimeZone::getNextTransition
virtual UBool getNextTransition(UDate base, UBool inclusive, TimeZoneTransition &result) const =0
Gets the first time zone transition after the base time.
icu::AnnualTimeZoneRule
AnnualTimeZoneRule is a class used for representing a time zone rule which takes effect annually.
Definition: tzrule.h:380
UClassID
void * UClassID
UClassID is used to identify classes without using the compiler's RTTI.
Definition: uobject.h:96
UErrorCode
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
Definition: utypes.h:415
basictz.h
C++ API: ICU TimeZone base class.
icu::TimeZone::getOffset
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 =0
Returns the TimeZone's adjusted GMT offset (i.e., the number of milliseconds to add to GMT to get loc...
icu::InitialTimeZoneRule
InitialTimeZoneRule represents a time zone rule representing a time zone effective from the beginning...
Definition: tzrule.h:202
icu::BasicTimeZone::countTransitionRules
virtual int32_t countTransitionRules(UErrorCode &status) const =0
Returns the number of TimeZoneRules which represents time transitions, for this time zone,...
icu::TimeZoneTransition
TimeZoneTransition is a class representing a time zone transition.
Definition: tztrans.h:35
icu::BasicTimeZone::getOffsetFromLocal
virtual void getOffsetFromLocal(UDate date, UTimeZoneLocalOption nonExistingTimeOpt, UTimeZoneLocalOption duplicatedTimeOpt, int32_t &rawOffset, int32_t &dstOffset, UErrorCode &status) const
Get time zone offsets from local wall time.
UTimeZoneLocalOption
UTimeZoneLocalOption
Options used by ucal_getTimeZoneOffsetFromLocal and BasicTimeZone::getOffsetFromLocal() to specify ho...
Definition: ucal.h:1626
UDate
double UDate
Date and Time data type.
Definition: utypes.h:203
icu::BasicTimeZone::operator=
BasicTimeZone & operator=(const BasicTimeZone &)=default
Copy assignment.
icu::TimeZone::useDaylightTime
virtual UBool useDaylightTime(void) const =0
Queries if this time zone uses daylight savings time.
icu::TimeZone::hasSameRules
virtual UBool hasSameRules(const TimeZone &other) const
Returns true if this zone has the same rule and offset as another zone.
icu::BasicTimeZone::getPreviousTransition
virtual UBool getPreviousTransition(UDate base, UBool inclusive, TimeZoneTransition &result) const =0
Gets the most recent time zone transition before the base time.
icu::BasicTimeZone::getTimeZoneRules
virtual void getTimeZoneRules(const InitialTimeZoneRule *&initial, const TimeZoneRule *trsrules[], int32_t &trscount, UErrorCode &status) const =0
Gets the InitialTimeZoneRule and the set of TimeZoneRule which represent time transitions for this ti...
icu::TimeZone::getRawOffset
virtual int32_t getRawOffset(void) const =0
Returns the TimeZone's raw GMT offset (i.e., the number of milliseconds to add to GMT to get local ti...