vtzone.h
Go to the documentation of this file.
// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
*******************************************************************************
* Copyright (C) 2007-2013, International Business Machines Corporation and
* others. All Rights Reserved.
*******************************************************************************
*/
#ifndef VTZONE_H
#define VTZONE_H
#include "unicode/utypes.h"
#if U_SHOW_CPLUSPLUS_API
#if !UCONFIG_NO_FORMATTING
#include "unicode/basictz.h"
U_NAMESPACE_BEGIN
class VTZWriter;
class VTZReader;
class UVector;
class U_I18N_API VTimeZone : public BasicTimeZone {
public:
VTimeZone(const VTimeZone& source);
virtual ~VTimeZone();
VTimeZone& operator=(const VTimeZone& right);
virtual bool operator==(const TimeZone& that) const override;
virtual bool operator!=(const TimeZone& that) const;
static VTimeZone* createVTimeZoneByID(const UnicodeString& ID);
static VTimeZone* createVTimeZoneFromBasicTimeZone(const BasicTimeZone& basicTZ,
UErrorCode &status);
static VTimeZone* createVTimeZone(const UnicodeString& vtzdata, UErrorCode& status);
UBool getTZURL(UnicodeString& url) const;
void setTZURL(const UnicodeString& url);
UBool getLastModified(UDate& lastModified) const;
void setLastModified(UDate lastModified);
void write(UnicodeString& result, UErrorCode& status) const;
void write(UDate start, UnicodeString& result, UErrorCode& status) const;
void writeSimple(UDate time, UnicodeString& result, UErrorCode& status) const;
virtual VTimeZone* clone() const override;
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 override;
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 override;
virtual void getOffset(UDate date, UBool local, int32_t& rawOffset,
int32_t& dstOffset, UErrorCode& ec) const override;
virtual void getOffsetFromLocal(
UDate date, UTimeZoneLocalOption nonExistingTimeOpt,
UTimeZoneLocalOption duplicatedTimeOpt,
int32_t& rawOffset, int32_t& dstOffset, UErrorCode& status) const override;
virtual void setRawOffset(int32_t offsetMillis) override;
virtual int32_t getRawOffset() const override;
virtual UBool useDaylightTime() const override;
#ifndef U_FORCE_HIDE_DEPRECATED_API
virtual UBool inDaylightTime(UDate date, UErrorCode& status) const override;
#endif // U_FORCE_HIDE_DEPRECATED_API
virtual UBool hasSameRules(const TimeZone& other) const override;
virtual UBool getNextTransition(UDate base, UBool inclusive, TimeZoneTransition& result) const override;
virtual UBool getPreviousTransition(UDate base, UBool inclusive, TimeZoneTransition& result) const override;
virtual int32_t countTransitionRules(UErrorCode& status) const override;
virtual void getTimeZoneRules(const InitialTimeZoneRule*& initial,
const TimeZoneRule* trsrules[], int32_t& trscount, UErrorCode& status) const override;
private:
enum { DEFAULT_VTIMEZONE_LINES = 100 };
VTimeZone();
void write(VTZWriter& writer, UErrorCode& status) const;
void write(UDate start, VTZWriter& writer, UErrorCode& status) const;
void writeSimple(UDate time, VTZWriter& writer, UErrorCode& status) const;
void load(VTZReader& reader, UErrorCode& status);
void parse(UErrorCode& status);
void writeZone(VTZWriter& w, BasicTimeZone& basictz, UVector* customProps,
UErrorCode& status) const;
void writeHeaders(VTZWriter& w, UErrorCode& status) const;
void writeFooter(VTZWriter& writer, UErrorCode& status) const;
void writeZonePropsByTime(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
int32_t fromOffset, int32_t toOffset, UDate time, UBool withRDATE,
UErrorCode& status) const;
void writeZonePropsByDOM(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
int32_t fromOffset, int32_t toOffset,
int32_t month, int32_t dayOfMonth, UDate startTime, UDate untilTime,
UErrorCode& status) const;
void writeZonePropsByDOW(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
int32_t fromOffset, int32_t toOffset,
int32_t month, int32_t weekInMonth, int32_t dayOfWeek,
UDate startTime, UDate untilTime, UErrorCode& status) const;
void writeZonePropsByDOW_GEQ_DOM(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
int32_t fromOffset, int32_t toOffset,
int32_t month, int32_t dayOfMonth, int32_t dayOfWeek,
UDate startTime, UDate untilTime, UErrorCode& status) const;
void writeZonePropsByDOW_GEQ_DOM_sub(VTZWriter& writer, int32_t month, int32_t dayOfMonth,
int32_t dayOfWeek, int32_t numDays,
UDate untilTime, int32_t fromOffset, UErrorCode& status) const;
void writeZonePropsByDOW_LEQ_DOM(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
int32_t fromOffset, int32_t toOffset,
int32_t month, int32_t dayOfMonth, int32_t dayOfWeek,
UDate startTime, UDate untilTime, UErrorCode& status) const;
void writeFinalRule(VTZWriter& writer, UBool isDst, const AnnualTimeZoneRule* rule,
int32_t fromRawOffset, int32_t fromDSTSavings,
UDate startTime, UErrorCode& status) const;
void beginZoneProps(VTZWriter& writer, UBool isDst, const UnicodeString& zonename,
int32_t fromOffset, int32_t toOffset, UDate startTime, UErrorCode& status) const;
void endZoneProps(VTZWriter& writer, UBool isDst, UErrorCode& status) const;
void beginRRULE(VTZWriter& writer, int32_t month, UErrorCode& status) const;
void appendUNTIL(VTZWriter& writer, const UnicodeString& until, UErrorCode& status) const;
BasicTimeZone *tz;
UVector *vtzlines;
UnicodeString tzurl;
UDate lastmod;
UnicodeString olsonzid;
UnicodeString icutzver;
public:
static UClassID U_EXPORT2 getStaticClassID();
virtual UClassID getDynamicClassID() const override;
};
U_NAMESPACE_END
#endif /* #if !UCONFIG_NO_FORMATTING */
#endif /* U_SHOW_CPLUSPLUS_API */
#endif // VTZONE_H
//eof
basictz.h
C++ API: ICU TimeZone base class.
icu::AnnualTimeZoneRule
AnnualTimeZoneRule is a class used for representing a time zone rule which takes effect annually.
Definition: tzrule.h:366
icu::BasicTimeZone
BasicTimeZone is an abstract class extending TimeZone.
Definition: basictz.h:38
icu::InitialTimeZoneRule
InitialTimeZoneRule represents a time zone rule representing a time zone effective from the beginning...
Definition: tzrule.h:202
icu::TimeZoneRule
TimeZoneRule is a class representing a rule for time zone.
Definition: tzrule.h:36
icu::TimeZoneTransition
TimeZoneTransition is a class representing a time zone transition.
Definition: tztrans.h:35
icu::TimeZone
TimeZone represents a time zone offset, and also figures out daylight savings.
Definition: timezone.h:133
icu::UnicodeString
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
Definition: unistr.h:296
icu::VTimeZone
VTimeZone is a class implementing RFC2445 VTIMEZONE.
Definition: vtzone.h:45
icu::VTimeZone::getDynamicClassID
virtual UClassID getDynamicClassID() const override
Returns a unique class ID POLYMORPHICALLY.
icu::VTimeZone::getOffset
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 override
Gets the time zone offset, for current date, modified in case of daylight savings.
icu::VTimeZone::createVTimeZone
static VTimeZone * createVTimeZone(const UnicodeString &vtzdata, UErrorCode &status)
Create a VTimeZone instance by RFC2445 VTIMEZONE data.
icu::VTimeZone::operator==
virtual bool operator==(const TimeZone &that) const override
Return true if the given TimeZone objects are semantically equal.
icu::VTimeZone::getTZURL
UBool getTZURL(UnicodeString &url) const
Gets the RFC2445 TZURL property value.
icu::VTimeZone::createVTimeZoneFromBasicTimeZone
static VTimeZone * createVTimeZoneFromBasicTimeZone(const BasicTimeZone &basicTZ, UErrorCode &status)
Create a VTimeZone instance using a basic time zone.
icu::VTimeZone::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 override
Returns the TimeZone's adjusted GMT offset (i.e., the number of milliseconds to add to GMT to get loc...
icu::VTimeZone::countTransitionRules
virtual int32_t countTransitionRules(UErrorCode &status) const override
Returns the number of TimeZoneRules which represents time transitions, for this time zone,...
icu::VTimeZone::inDaylightTime
virtual UBool inDaylightTime(UDate date, UErrorCode &status) const override
Queries if the given date is in daylight savings time in this time zone.
icu::VTimeZone::writeSimple
void writeSimple(UDate time, UnicodeString &result, UErrorCode &status) const
Writes RFC2445 VTIMEZONE data applicable for the specified date.
icu::VTimeZone::hasSameRules
virtual UBool hasSameRules(const TimeZone &other) const override
Returns true if this zone has the same rule and offset as another zone.
icu::VTimeZone::write
void write(UDate start, UnicodeString &result, UErrorCode &status) const
Writes RFC2445 VTIMEZONE data for this time zone applicable for dates after the specified start time.
icu::VTimeZone::getNextTransition
virtual UBool getNextTransition(UDate base, UBool inclusive, TimeZoneTransition &result) const override
Gets the first time zone transition after the base time.
icu::VTimeZone::getStaticClassID
static UClassID getStaticClassID()
Return the class ID for this class.
icu::VTimeZone::setRawOffset
virtual void setRawOffset(int32_t offsetMillis) override
Sets the TimeZone's raw GMT offset (i.e., the number of milliseconds to add to GMT to get local time,...
icu::VTimeZone::createVTimeZoneByID
static VTimeZone * createVTimeZoneByID(const UnicodeString &ID)
Create a VTimeZone instance by the time zone ID.
icu::VTimeZone::getRawOffset
virtual int32_t getRawOffset() const override
Returns the TimeZone's raw GMT offset (i.e., the number of milliseconds to add to GMT to get local ti...
icu::VTimeZone::write
void write(UnicodeString &result, UErrorCode &status) const
Writes RFC2445 VTIMEZONE data for this time zone.
icu::VTimeZone::setLastModified
void setLastModified(UDate lastModified)
Sets the RFC2445 LAST-MODIFIED property value.
icu::VTimeZone::getOffsetFromLocal
virtual void getOffsetFromLocal(UDate date, UTimeZoneLocalOption nonExistingTimeOpt, UTimeZoneLocalOption duplicatedTimeOpt, int32_t &rawOffset, int32_t &dstOffset, UErrorCode &status) const override
Get time zone offsets from local wall time.
icu::VTimeZone::operator!=
virtual bool operator!=(const TimeZone &that) const
Return true if the given TimeZone objects are semantically unequal.
icu::VTimeZone::setTZURL
void setTZURL(const UnicodeString &url)
Sets the RFC2445 TZURL property value.
icu::VTimeZone::~VTimeZone
virtual ~VTimeZone()
Destructor.
icu::VTimeZone::getLastModified
UBool getLastModified(UDate &lastModified) const
Gets the RFC2445 LAST-MODIFIED property value.
icu::VTimeZone::useDaylightTime
virtual UBool useDaylightTime() const override
Queries if this time zone uses daylight savings time.
icu::VTimeZone::getOffset
virtual void getOffset(UDate date, UBool local, int32_t &rawOffset, int32_t &dstOffset, UErrorCode &ec) const override
Returns the time zone raw and GMT offset for the given moment in time.
icu::VTimeZone::clone
virtual VTimeZone * clone() const override
Clones TimeZone objects polymorphically.
icu::VTimeZone::operator=
VTimeZone & operator=(const VTimeZone &right)
Assignment operator.
icu::VTimeZone::VTimeZone
VTimeZone(const VTimeZone &source)
Copy constructor.
icu::VTimeZone::getPreviousTransition
virtual UBool getPreviousTransition(UDate base, UBool inclusive, TimeZoneTransition &result) const override
Gets the most recent time zone transition before the base time.
icu::VTimeZone::getTimeZoneRules
virtual void getTimeZoneRules(const InitialTimeZoneRule *&initial, const TimeZoneRule *trsrules[], int32_t &trscount, UErrorCode &status) const override
Gets the InitialTimeZoneRule and the set of TimeZoneRule which represent time transitions for this ti...
UTimeZoneLocalOption
UTimeZoneLocalOption
Options used by ucal_getTimeZoneOffsetFromLocal and BasicTimeZone::getOffsetFromLocal() to specify ho...
Definition: ucal.h:1682
UBool
int8_t UBool
The ICU boolean type, a signed-byte integer.
Definition: umachine.h:247
UClassID
void * UClassID
UClassID is used to identify classes without using the compiler's RTTI.
Definition: uobject.h:96
utypes.h
Basic definitions for ICU, for both C and C++ APIs.
UErrorCode
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
Definition: utypes.h:430
U_I18N_API
#define U_I18N_API
Set to export library symbols from inside the i18n library, and to import them from outside.
Definition: utypes.h:316
UDate
double UDate
Date and Time data type.
Definition: utypes.h:218