ICU 59.1  59.1
Public Member Functions | Static Public Member Functions
icu::VTimeZone Class Reference

VTimeZone is a class implementing RFC2445 VTIMEZONE. More...

#include <vtzone.h>

Inheritance diagram for icu::VTimeZone:
icu::BasicTimeZone icu::TimeZone icu::UObject icu::UMemory

Public Member Functions

 VTimeZone (const VTimeZone &source)
 Copy constructor. More...
 
virtual ~VTimeZone ()
 Destructor. More...
 
VTimeZoneoperator= (const VTimeZone &right)
 Assignment operator. More...
 
virtual UBool operator== (const TimeZone &that) const
 Return true if the given TimeZone objects are semantically equal. More...
 
virtual UBool operator!= (const TimeZone &that) const
 Return true if the given TimeZone objects are semantically unequal. More...
 
UBool getTZURL (UnicodeString &url) const
 Gets the RFC2445 TZURL property value. More...
 
void setTZURL (const UnicodeString &url)
 Sets the RFC2445 TZURL property value. More...
 
UBool getLastModified (UDate &lastModified) const
 Gets the RFC2445 LAST-MODIFIED property value. More...
 
void setLastModified (UDate lastModified)
 Sets the RFC2445 LAST-MODIFIED property value. More...
 
void write (UnicodeString &result, UErrorCode &status) const
 Writes RFC2445 VTIMEZONE data for this time zone. More...
 
void write (UDate start, UnicodeString &result, UErrorCode &status) const
 Writes RFC2445 VTIMEZONE data for this time zone applicalbe for dates after the specified start time. More...
 
void writeSimple (UDate time, UnicodeString &result, UErrorCode &status) const
 Writes RFC2445 VTIMEZONE data applicalbe for the specified date. More...
 
virtual TimeZoneclone (void) const
 Clones TimeZone objects polymorphically. More...
 
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
 Returns the TimeZone's adjusted GMT offset (i.e., the number of milliseconds to add to GMT to get local time in this time zone, taking daylight savings time into account) as of a particular reference date. More...
 
virtual int32_t getOffset (uint8_t era, int32_t year, int32_t month, int32_t day, uint8_t dayOfWeek, int32_t millis, int32_t monthLength, UErrorCode &status) const
 Gets the time zone offset, for current date, modified in case of daylight savings. More...
 
virtual void getOffset (UDate date, UBool local, int32_t &rawOffset, int32_t &dstOffset, UErrorCode &ec) const
 Returns the time zone raw and GMT offset for the given moment in time. More...
 
virtual void setRawOffset (int32_t offsetMillis)
 Sets the TimeZone's raw GMT offset (i.e., the number of milliseconds to add to GMT to get local time, before taking daylight savings time into account). More...
 
virtual int32_t getRawOffset (void) const
 Returns the TimeZone's raw GMT offset (i.e., the number of milliseconds to add to GMT to get local time, before taking daylight savings time into account). More...
 
virtual UBool useDaylightTime (void) const
 Queries if this time zone uses daylight savings time. More...
 
virtual UBool inDaylightTime (UDate date, UErrorCode &status) const
 Queries if the given date is in daylight savings time in this time zone. More...
 
virtual UBool hasSameRules (const TimeZone &other) const
 Returns true if this zone has the same rule and offset as another zone. More...
 
virtual UBool getNextTransition (UDate base, UBool inclusive, TimeZoneTransition &result) const
 Gets the first time zone transition after the base time. More...
 
virtual UBool getPreviousTransition (UDate base, UBool inclusive, TimeZoneTransition &result) const
 Gets the most recent time zone transition before the base time. More...
 
virtual int32_t countTransitionRules (UErrorCode &status) const
 Returns the number of TimeZoneRules which represents time transitions, for this time zone, that is, all TimeZoneRules for this time zone except InitialTimeZoneRule. More...
 
virtual void getTimeZoneRules (const InitialTimeZoneRule *&initial, const TimeZoneRule *trsrules[], int32_t &trscount, UErrorCode &status) const
 Gets the InitialTimeZoneRule and the set of TimeZoneRule which represent time transitions for this time zone. More...
 
virtual UClassID getDynamicClassID (void) const
 Returns a unique class ID POLYMORPHICALLY. More...
 
- Public Member Functions inherited from icu::BasicTimeZone
virtual ~BasicTimeZone ()
 Destructor. More...
 
virtual UBool hasEquivalentTransitions (const BasicTimeZone &tz, UDate start, UDate end, UBool ignoreDstAmount, UErrorCode &ec) const
 Checks if the time zone has equivalent transitions in the time range. More...
 
virtual void getSimpleRulesNear (UDate date, InitialTimeZoneRule *&initial, AnnualTimeZoneRule *&std, AnnualTimeZoneRule *&dst, UErrorCode &status) const
 Gets the set of time zone rules valid at the specified time. More...
 
virtual void getOffsetFromLocal (UDate date, int32_t nonExistingTimeOpt, int32_t duplicatedTimeOpt, int32_t &rawOffset, int32_t &dstOffset, UErrorCode &status) const
 Get time zone offsets from local wall time. More...
 
- Public Member Functions inherited from icu::TimeZone
virtual ~TimeZone ()
 
UBool operator!= (const TimeZone &that) const
 Returns true if the two TimeZones are NOT equal; that is, if operator==() returns false. More...
 
UnicodeStringgetID (UnicodeString &ID) const
 Fills in "ID" with the TimeZone's ID. More...
 
void setID (const UnicodeString &ID)
 Sets the TimeZone's ID to the specified value. More...
 
UnicodeStringgetDisplayName (UnicodeString &result) const
 Returns a name of this time zone suitable for presentation to the user in the default locale. More...
 
UnicodeStringgetDisplayName (const Locale &locale, UnicodeString &result) const
 Returns a name of this time zone suitable for presentation to the user in the specified locale. More...
 
UnicodeStringgetDisplayName (UBool daylight, EDisplayType style, UnicodeString &result) const
 Returns a name of this time zone suitable for presentation to the user in the default locale. More...
 
UnicodeStringgetDisplayName (UBool daylight, EDisplayType style, const Locale &locale, UnicodeString &result) const
 Returns a name of this time zone suitable for presentation to the user in the specified locale. More...
 
virtual int32_t getDSTSavings () const
 Returns the amount of time to be added to local standard time to get local wall clock time. More...
 
- Public Member Functions inherited from icu::UObject
virtual ~UObject ()
 Destructor. More...
 

Static Public Member Functions

static VTimeZonecreateVTimeZoneByID (const UnicodeString &ID)
 Create a VTimeZone instance by the time zone ID. More...
 
static VTimeZonecreateVTimeZoneFromBasicTimeZone (const BasicTimeZone &basicTZ, UErrorCode &status)
 Create a VTimeZone instance using a basic time zone. More...
 
static VTimeZonecreateVTimeZone (const UnicodeString &vtzdata, UErrorCode &status)
 Create a VTimeZone instance by RFC2445 VTIMEZONE data. More...
 
static UClassID getStaticClassID (void)
 Return the class ID for this class. More...
 
- Static Public Member Functions inherited from icu::TimeZone
static const TimeZonegetUnknown ()
 Returns the "unknown" time zone. More...
 
static const TimeZonegetGMT (void)
 The GMT (=UTC) time zone has a raw offset of zero and does not use daylight savings time. More...
 
static TimeZonecreateTimeZone (const UnicodeString &ID)
 Creates a TimeZone for the given ID. More...
 
static StringEnumerationcreateTimeZoneIDEnumeration (USystemTimeZoneType zoneType, const char *region, const int32_t *rawOffset, UErrorCode &ec)
 Returns an enumeration over system time zone IDs with the given filter conditions. More...
 
static StringEnumerationcreateEnumeration ()
 Returns an enumeration over all recognized time zone IDs. More...
 
static StringEnumerationcreateEnumeration (int32_t rawOffset)
 Returns an enumeration over time zone IDs with a given raw offset from GMT. More...
 
static StringEnumerationcreateEnumeration (const char *country)
 Returns an enumeration over time zone IDs associated with the given country. More...
 
static int32_t countEquivalentIDs (const UnicodeString &id)
 Returns the number of IDs in the equivalency group that includes the given ID. More...
 
static const UnicodeString getEquivalentID (const UnicodeString &id, int32_t index)
 Returns an ID in the equivalency group that includes the given ID. More...
 
static TimeZonedetectHostTimeZone ()
 Creates an instance of TimeZone detected from the current host system configuration. More...
 
static TimeZonecreateDefault (void)
 Creates a new copy of the default TimeZone for this host. More...
 
static void adoptDefault (TimeZone *zone)
 Sets the default time zone (i.e., what's returned by createDefault()) to be the specified time zone. More...
 
static void setDefault (const TimeZone &zone)
 Same as adoptDefault(), except that the TimeZone object passed in is NOT adopted; the caller remains responsible for deleting it. More...
 
static const char * getTZDataVersion (UErrorCode &status)
 Returns the timezone data version currently used by ICU. More...
 
static UnicodeStringgetCanonicalID (const UnicodeString &id, UnicodeString &canonicalID, UErrorCode &status)
 Returns the canonical system timezone ID or the normalized custom time zone ID for the given time zone ID. More...
 
static UnicodeStringgetCanonicalID (const UnicodeString &id, UnicodeString &canonicalID, UBool &isSystemID, UErrorCode &status)
 Returns the canonical system time zone ID or the normalized custom time zone ID for the given time zone ID. More...
 
static UnicodeStringgetWindowsID (const UnicodeString &id, UnicodeString &winid, UErrorCode &status)
 Converts a system time zone ID to an equivalent Windows time zone ID. More...
 
static UnicodeStringgetIDForWindowsID (const UnicodeString &winid, const char *region, UnicodeString &id, UErrorCode &status)
 Converts a Windows time zone ID to an equivalent system time zone ID for a region. More...
 
static UClassID getStaticClassID (void)
 Return the class ID for this class. More...
 
static int32_t getRegion (const UnicodeString &id, char *region, int32_t capacity, UErrorCode &status)
 Gets the region code associated with the given system time zone ID. More...
 
static const char16_t * getRegion (const UnicodeString &id, UErrorCode &status)
 Returns the region code associated with the given zone, or NULL if the zone is not known. More...
 

Additional Inherited Members

- Public Types inherited from icu::BasicTimeZone
enum  { kStandard = 0x01, kDaylight = 0x03, kFormer = 0x04, kLatter = 0x0C }
 The time type option bit flags used by getOffsetFromLocal. More...
 
- Public Types inherited from icu::TimeZone
enum  EDisplayType {
  SHORT = 1, LONG, SHORT_GENERIC, LONG_GENERIC,
  SHORT_GMT, LONG_GMT, SHORT_COMMONLY_USED, GENERIC_LOCATION
}
 Enum for use with getDisplayName. More...
 
- Protected Types inherited from icu::BasicTimeZone
enum  { kStdDstMask = kDaylight, kFormerLatterMask = kLatter }
 The time type option bit masks used by getOffsetFromLocal. More...
 
- Protected Member Functions inherited from icu::BasicTimeZone
 BasicTimeZone ()
 Default constructor. More...
 
 BasicTimeZone (const UnicodeString &id)
 Construct a timezone with a given ID. More...
 
 BasicTimeZone (const BasicTimeZone &source)
 Copy constructor. More...
 
void getTimeZoneRulesAfter (UDate start, InitialTimeZoneRule *&initial, UVector *&transitionRules, UErrorCode &status) const
 Gets the set of TimeZoneRule instances applicable to the specified time and after. More...
 
- Protected Member Functions inherited from icu::TimeZone
 TimeZone ()
 Default constructor. More...
 
 TimeZone (const UnicodeString &id)
 Construct a TimeZone with a given ID. More...
 
 TimeZone (const TimeZone &source)
 Copy constructor. More...
 
TimeZoneoperator= (const TimeZone &right)
 Default assignment operator. More...
 
- Static Protected Member Functions inherited from icu::TimeZone
static UResourceBundleloadRule (const UResourceBundle *top, const UnicodeString &ruleid, UResourceBundle *oldbundle, UErrorCode &status)
 Utility function. More...
 

Detailed Description

VTimeZone is a class implementing RFC2445 VTIMEZONE.

You can create a VTimeZone instance from a time zone ID supported by TimeZone. With the VTimeZone instance created from the ID, you can write out the rule in RFC2445 VTIMEZONE format. Also, you can create a VTimeZone instance from RFC2445 VTIMEZONE data stream, which allows you to calculate time zone offset by the rules defined by the data. Or, you can create a VTimeZone from any other ICU BasicTimeZone.

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 3.8

Definition at line 43 of file vtzone.h.

Constructor & Destructor Documentation

§ VTimeZone()

icu::VTimeZone::VTimeZone ( const VTimeZone source)

Copy constructor.

Parameters
sourceThe VTimeZone object to be copied.
Stable:
ICU 3.8

§ ~VTimeZone()

virtual icu::VTimeZone::~VTimeZone ( )
virtual

Destructor.

Stable:
ICU 3.8

Member Function Documentation

§ clone()

virtual TimeZone* icu::VTimeZone::clone ( void  ) const
virtual

Clones TimeZone objects polymorphically.

Clients are responsible for deleting the TimeZone object cloned.

Returns
A new copy of this TimeZone object.
Stable:
ICU 3.8

Implements icu::TimeZone.

§ countTransitionRules()

virtual int32_t icu::VTimeZone::countTransitionRules ( UErrorCode status) const
virtual

Returns the number of TimeZoneRules which represents time transitions, for this time zone, that is, all TimeZoneRules for this time zone except InitialTimeZoneRule.

The return value range is 0 or any positive value.

Parameters
statusReceives error status code.
Returns
The number of TimeZoneRules representing time transitions.
Stable:
ICU 3.8

Implements icu::BasicTimeZone.

§ createVTimeZone()

static VTimeZone* icu::VTimeZone::createVTimeZone ( const UnicodeString vtzdata,
UErrorCode status 
)
static

Create a VTimeZone instance by RFC2445 VTIMEZONE data.

Parameters
vtzdataThe string including VTIMEZONE data block
statusOutput param to filled in with a success or an error.
Returns
A VTimeZone initialized by the VTIMEZONE data or NULL if failed to load the rule from the VTIMEZONE data.
Stable:
ICU 3.8

§ createVTimeZoneByID()

static VTimeZone* icu::VTimeZone::createVTimeZoneByID ( const UnicodeString ID)
static

Create a VTimeZone instance by the time zone ID.

Parameters
IDThe time zone ID, such as America/New_York
Returns
A VTimeZone object initialized by the time zone ID, or NULL when the ID is unknown.
Stable:
ICU 3.8

§ createVTimeZoneFromBasicTimeZone()

static VTimeZone* icu::VTimeZone::createVTimeZoneFromBasicTimeZone ( const BasicTimeZone basicTZ,
UErrorCode status 
)
static

Create a VTimeZone instance using a basic time zone.

Parameters
basicTZThe basic time zone instance
statusOutput param to filled in with a success or an error.
Returns
A VTimeZone object initialized by the basic time zone.
Stable:
ICU 4.6

§ getDynamicClassID()

virtual UClassID icu::VTimeZone::getDynamicClassID ( void  ) const
virtual

Returns a unique class ID POLYMORPHICALLY.

Pure virtual override. This method is to implement a simple version of RTTI, since not all C++ compilers support genuine RTTI. Polymorphic operator==() and clone() methods call this method.

Returns
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 3.8

Implements icu::TimeZone.

§ getLastModified()

UBool icu::VTimeZone::getLastModified ( UDate lastModified) const

Gets the RFC2445 LAST-MODIFIED property value.

When a VTimeZone instance was created from VTIMEZONE data, the initial value is set by the LAST-MODIFIED property value in the data. Otherwise, the initial value is not set.

Parameters
lastModifiedReceives the last modified date.
Returns
TRUE if lastModified attribute is available and value is set.
Stable:
ICU 3.8

§ getNextTransition()

virtual UBool icu::VTimeZone::getNextTransition ( UDate  base,
UBool  inclusive,
TimeZoneTransition result 
) const
virtual

Gets the first time zone transition after the base time.

Parameters
baseThe base time.
inclusiveWhether the base time is inclusive or not.
resultReceives the first transition after the base time.
Returns
TRUE if the transition is found.
Stable:
ICU 3.8

Implements icu::BasicTimeZone.

§ getOffset() [1/3]

virtual int32_t icu::VTimeZone::getOffset ( uint8_t  era,
int32_t  year,
int32_t  month,
int32_t  day,
uint8_t  dayOfWeek,
int32_t  millis,
UErrorCode status 
) const
virtual

Returns the TimeZone's adjusted GMT offset (i.e., the number of milliseconds to add to GMT to get local time in this time zone, taking daylight savings time into account) as of a particular reference date.

The reference date is used to determine whether daylight savings time is in effect and needs to be figured into the offset that is returned (in other words, what is the adjusted GMT offset in this time zone at this particular date and time?). For the time zones produced by createTimeZone(), the reference data is specified according to the Gregorian calendar, and the date and time fields are local standard time.

Note: Don't call this method. Instead, call the getOffset(UDate...) overload, which returns both the raw and the DST offset for a given time. This method is retained only for backward compatibility.

Parameters
eraThe reference date's era
yearThe reference date's year
monthThe reference date's month (0-based; 0 is January)
dayThe reference date's day-in-month (1-based)
dayOfWeekThe reference date's day-of-week (1-based; 1 is Sunday)
millisThe reference date's milliseconds in day, local standard time
statusOutput param to filled in with a success or an error.
Returns
The offset in milliseconds to add to GMT to get local time.
Stable:
ICU 3.8

Implements icu::TimeZone.

§ getOffset() [2/3]

virtual int32_t icu::VTimeZone::getOffset ( uint8_t  era,
int32_t  year,
int32_t  month,
int32_t  day,
uint8_t  dayOfWeek,
int32_t  millis,
int32_t  monthLength,
UErrorCode status 
) const
virtual

Gets the time zone offset, for current date, modified in case of daylight savings.

This is the offset to add to UTC to get local time.

Note: Don't call this method. Instead, call the getOffset(UDate...) overload, which returns both the raw and the DST offset for a given time. This method is retained only for backward compatibility.

Parameters
eraThe reference date's era
yearThe reference date's year
monthThe reference date's month (0-based; 0 is January)
dayThe reference date's day-in-month (1-based)
dayOfWeekThe reference date's day-of-week (1-based; 1 is Sunday)
millisThe reference date's milliseconds in day, local standard time
monthLengthThe length of the given month in days.
statusOutput param to filled in with a success or an error.
Returns
The offset in milliseconds to add to GMT to get local time.
Stable:
ICU 3.8

Implements icu::TimeZone.

§ getOffset() [3/3]

virtual void icu::VTimeZone::getOffset ( UDate  date,
UBool  local,
int32_t &  rawOffset,
int32_t &  dstOffset,
UErrorCode ec 
) const
virtual

Returns the time zone raw and GMT offset for the given moment in time.

Upon return, local-millis = GMT-millis + rawOffset + dstOffset. All computations are performed in the proleptic Gregorian calendar. The default implementation in the TimeZone class delegates to the 8-argument getOffset().

Parameters
datemoment in time for which to return offsets, in units of milliseconds from January 1, 1970 0:00 GMT, either GMT time or local wall time, depending on `local'.
localif true, `date' is local wall time; otherwise it is in GMT time.
rawOffsetoutput parameter to receive the raw offset, that is, the offset not including DST adjustments
dstOffsetoutput parameter to receive the DST offset, that is, the offset to be added to `rawOffset' to obtain the total offset between local and GMT time. If DST is not in effect, this value is zero; otherwise it is a positive value, typically one hour.
ecinput-output error code
Stable:
ICU 3.8

Reimplemented from icu::TimeZone.

§ getPreviousTransition()

virtual UBool icu::VTimeZone::getPreviousTransition ( UDate  base,
UBool  inclusive,
TimeZoneTransition result 
) const
virtual

Gets the most recent time zone transition before the base time.

Parameters
baseThe base time.
inclusiveWhether the base time is inclusive or not.
resultReceives the most recent transition before the base time.
Returns
TRUE if the transition is found.
Stable:
ICU 3.8

Implements icu::BasicTimeZone.

§ getRawOffset()

virtual int32_t icu::VTimeZone::getRawOffset ( void  ) const
virtual

Returns the TimeZone's raw GMT offset (i.e., the number of milliseconds to add to GMT to get local time, before taking daylight savings time into account).

Returns
The TimeZone's raw GMT offset.
Stable:
ICU 3.8

Implements icu::TimeZone.

§ getStaticClassID()

static UClassID icu::VTimeZone::getStaticClassID ( void  )
static

Return the class ID for this class.

This is useful only for comparing to a return value from getDynamicClassID(). For example:

.   Base* polymorphic_pointer = createPolymorphicObject();
.   if (polymorphic_pointer->getDynamicClassID() ==
.       erived::getStaticClassID()) ...
Returns
The class ID for all objects of this class.
Stable:
ICU 3.8

§ getTimeZoneRules()

virtual void icu::VTimeZone::getTimeZoneRules ( const InitialTimeZoneRule *&  initial,
const TimeZoneRule trsrules[],
int32_t &  trscount,
UErrorCode status 
) const
virtual

Gets the InitialTimeZoneRule and the set of TimeZoneRule which represent time transitions for this time zone.

On successful return, the argument initial points to non-NULL InitialTimeZoneRule and the array trsrules is filled with 0 or multiple TimeZoneRule instances up to the size specified by trscount. The results are referencing the rule instance held by this time zone instance. Therefore, after this time zone is destructed, they are no longer available.

Parameters
initialReceives the initial timezone rule
trsrulesReceives the timezone transition rules
trscountOn input, specify the size of the array 'transitions' receiving the timezone transition rules. On output, actual number of rules filled in the array will be set.
statusReceives error status code.
Stable:
ICU 3.8

Implements icu::BasicTimeZone.

§ getTZURL()

UBool icu::VTimeZone::getTZURL ( UnicodeString url) const

Gets the RFC2445 TZURL property value.

When a VTimeZone instance was created from VTIMEZONE data, the initial value is set by the TZURL property value in the data. Otherwise, the initial value is not set.

Parameters
urlReceives the RFC2445 TZURL property value.
Returns
TRUE if TZURL attribute is available and value is set.
Stable:
ICU 3.8

§ hasSameRules()

virtual UBool icu::VTimeZone::hasSameRules ( const TimeZone other) const
virtual

Returns true if this zone has the same rule and offset as another zone.

That is, if this zone differs only in ID, if at all.

Parameters
otherthe TimeZone object to be compared with
Returns
true if the given zone is the same as this one, with the possible exception of the ID
Stable:
ICU 3.8

Reimplemented from icu::TimeZone.

§ inDaylightTime()

virtual UBool icu::VTimeZone::inDaylightTime ( UDate  date,
UErrorCode status 
) const
virtual

Queries if the given date is in daylight savings time in this time zone.

This method is wasteful since it creates a new GregorianCalendar and deletes it each time it is called. This is a deprecated method and provided only for Java compatibility.

Parameters
datethe given UDate.
statusOutput param filled in with success/error code.
Returns
true if the given date is in daylight savings time, false, otherwise.
Deprecated:
ICU 2.4. Use Calendar::inDaylightTime() instead.

Implements icu::TimeZone.

§ operator!=()

virtual UBool icu::VTimeZone::operator!= ( const TimeZone that) const
virtual

Return true if the given TimeZone objects are semantically unequal.

Objects of different subclasses are considered unequal.

Parameters
thatThe object to be compared with.
Returns
true if the given TimeZone objects are semantically unequal.
Stable:
ICU 3.8

§ operator=()

VTimeZone& icu::VTimeZone::operator= ( const VTimeZone right)

Assignment operator.

Parameters
rightThe object to be copied.
Stable:
ICU 3.8

§ operator==()

virtual UBool icu::VTimeZone::operator== ( const TimeZone that) const
virtual

Return true if the given TimeZone objects are semantically equal.

Objects of different subclasses are considered unequal.

Parameters
thatThe object to be compared with.
Returns
true if the given TimeZone objects are semantically equal.
Stable:
ICU 3.8

Reimplemented from icu::TimeZone.

§ setLastModified()

void icu::VTimeZone::setLastModified ( UDate  lastModified)

Sets the RFC2445 LAST-MODIFIED property value.

Parameters
lastModifiedThe LAST-MODIFIED date.
Stable:
ICU 3.8

§ setRawOffset()

virtual void icu::VTimeZone::setRawOffset ( int32_t  offsetMillis)
virtual

Sets the TimeZone's raw GMT offset (i.e., the number of milliseconds to add to GMT to get local time, before taking daylight savings time into account).

Parameters
offsetMillisThe new raw GMT offset for this time zone.
Stable:
ICU 3.8

Implements icu::TimeZone.

§ setTZURL()

void icu::VTimeZone::setTZURL ( const UnicodeString url)

Sets the RFC2445 TZURL property value.

Parameters
urlThe TZURL property value.
Stable:
ICU 3.8

§ useDaylightTime()

virtual UBool icu::VTimeZone::useDaylightTime ( void  ) const
virtual

Queries if this time zone uses daylight savings time.

Returns
true if this time zone uses daylight savings time, false, otherwise.
Stable:
ICU 3.8

Implements icu::TimeZone.

§ write() [1/2]

void icu::VTimeZone::write ( UnicodeString result,
UErrorCode status 
) const

Writes RFC2445 VTIMEZONE data for this time zone.

Parameters
resultOutput param to filled in with the VTIMEZONE data.
statusOutput param to filled in with a success or an error.
Stable:
ICU 3.8

§ write() [2/2]

void icu::VTimeZone::write ( UDate  start,
UnicodeString result,
UErrorCode status 
) const

Writes RFC2445 VTIMEZONE data for this time zone applicalbe for dates after the specified start time.

Parameters
startThe start date.
resultOutput param to filled in with the VTIMEZONE data.
statusOutput param to filled in with a success or an error.
Stable:
ICU 3.8

§ writeSimple()

void icu::VTimeZone::writeSimple ( UDate  time,
UnicodeString result,
UErrorCode status 
) const

Writes RFC2445 VTIMEZONE data applicalbe for the specified date.

Some common iCalendar implementations can only handle a single time zone property or a pair of standard and daylight time properties using BYDAY rule with day of week (such as BYDAY=1SUN). This method produce the VTIMEZONE data which can be handled these implementations. The rules produced by this method can be used only for calculating time zone offset around the specified date.

Parameters
timeThe date used for rule extraction.
resultOutput param to filled in with the VTIMEZONE data.
statusOutput param to filled in with a success or an error.
Stable:
ICU 3.8

The documentation for this class was generated from the following file: