Concrete class which provides the standard calendar used by most of the world. More...

#include <gregocal.h>

Inheritance diagram for icu::GregorianCalendar:

Public Types
enum	EEras { BC , AD }
	Useful constants for GregorianCalendar and TimeZone. More...

Public Types inherited from icu::Calendar
enum	EDateFields { ERA , YEAR , MONTH , WEEK_OF_YEAR , WEEK_OF_MONTH , DATE , DAY_OF_YEAR , DAY_OF_WEEK , DAY_OF_WEEK_IN_MONTH , AM_PM , HOUR , HOUR_OF_DAY , MINUTE , SECOND , MILLISECOND , ZONE_OFFSET , DST_OFFSET , YEAR_WOY , DOW_LOCAL , EXTENDED_YEAR , JULIAN_DAY , MILLISECONDS_IN_DAY , IS_LEAP_MONTH , FIELD_COUNT = UCAL_FIELD_COUNT }
	Field IDs for date and time. More...

enum	EDaysOfWeek { SUNDAY = 1 , MONDAY , TUESDAY , WEDNESDAY , THURSDAY , FRIDAY , SATURDAY }
	Useful constant for days of week. More...

enum	EMonths { JANUARY , FEBRUARY , MARCH , APRIL , MAY , JUNE , JULY , AUGUST , SEPTEMBER , OCTOBER , NOVEMBER , DECEMBER , UNDECIMBER }
	Useful constants for month. More...

enum	EAmpm { AM , PM }
	Useful constants for hour in 12-hour clock. More...

Public Member Functions
	GregorianCalendar (UErrorCode &success)
	Constructs a default GregorianCalendar using the current time in the default time zone with the default locale. More...

	GregorianCalendar (TimeZone *zoneToAdopt, UErrorCode &success)
	Constructs a GregorianCalendar based on the current time in the given time zone with the default locale. More...

	GregorianCalendar (const TimeZone &zone, UErrorCode &success)
	Constructs a GregorianCalendar based on the current time in the given time zone with the default locale. More...

	GregorianCalendar (const Locale &aLocale, UErrorCode &success)
	Constructs a GregorianCalendar based on the current time in the default time zone with the given locale. More...

	GregorianCalendar (TimeZone *zoneToAdopt, const Locale &aLocale, UErrorCode &success)
	Constructs a GregorianCalendar based on the current time in the given time zone with the given locale. More...

	GregorianCalendar (const TimeZone &zone, const Locale &aLocale, UErrorCode &success)
	Constructs a GregorianCalendar based on the current time in the given time zone with the given locale. More...

	GregorianCalendar (int32_t year, int32_t month, int32_t date, UErrorCode &success)
	Constructs a GregorianCalendar with the given AD date set in the default time zone with the default locale. More...

	GregorianCalendar (int32_t year, int32_t month, int32_t date, int32_t hour, int32_t minute, UErrorCode &success)
	Constructs a GregorianCalendar with the given AD date and time set for the default time zone with the default locale. More...

	GregorianCalendar (int32_t year, int32_t month, int32_t date, int32_t hour, int32_t minute, int32_t second, UErrorCode &success)
	Constructs a GregorianCalendar with the given AD date and time set for the default time zone with the default locale. More...

virtual	~GregorianCalendar ()
	Destructor. More...

	GregorianCalendar (const GregorianCalendar &source)
	Copy constructor. More...

GregorianCalendar &	operator= (const GregorianCalendar &right)
	Default assignment operator. More...

virtual GregorianCalendar *	clone () const override
	Create and return a polymorphic copy of this calendar. More...

void	setGregorianChange (UDate date, UErrorCode &success)
	Sets the GregorianCalendar change date. More...

UDate	getGregorianChange () const
	Gets the Gregorian Calendar change date. More...

UBool	isLeapYear (int32_t year) const
	Return true if the given year is a leap year. More...

virtual UBool	isEquivalentTo (const Calendar &other) const override
	Returns true if the given Calendar object is equivalent to this one. More...

virtual void	roll (EDateFields field, int32_t amount, UErrorCode &status) override
	(Overrides Calendar) Rolls up or down by the given amount in the specified field. More...

virtual void	roll (UCalendarDateFields field, int32_t amount, UErrorCode &status) override
	(Overrides Calendar) Rolls up or down by the given amount in the specified field. More...

int32_t	getActualMinimum (EDateFields field) const
	Return the minimum value that this field could have, given the current date. More...

int32_t	getActualMinimum (EDateFields field, UErrorCode &status) const
	Return the minimum value that this field could have, given the current date. More...

int32_t	getActualMinimum (UCalendarDateFields field, UErrorCode &status) const override
	Return the minimum value that this field could have, given the current date. More...

virtual int32_t	getActualMaximum (UCalendarDateFields field, UErrorCode &status) const override
	Return the maximum value that this field could have, given the current date. More...

virtual UClassID	getDynamicClassID () const override
	Override Calendar Returns a unique class ID POLYMORPHICALLY. More...

virtual const char *	getType () const override
	Returns the calendar type name string for this Calendar object. More...

Public Member Functions inherited from icu::Calendar
virtual	~Calendar ()
	destructor More...

UDate	getTime (UErrorCode &status) const
	Gets this Calendar's time as milliseconds. More...

void	setTime (UDate date, UErrorCode &status)
	Sets this Calendar's current time with the given UDate. More...

virtual bool	operator== (const Calendar &that) const
	Compares the equality of two Calendar objects. More...

bool	operator!= (const Calendar &that) const
	Compares the inequality of two Calendar objects. More...

UBool	equals (const Calendar &when, UErrorCode &status) const
	Compares the Calendar time, whereas Calendar::operator== compares the equality of Calendar objects. More...

UBool	before (const Calendar &when, UErrorCode &status) const
	Returns true if this Calendar's current time is before "when"'s current time. More...

UBool	after (const Calendar &when, UErrorCode &status) const
	Returns true if this Calendar's current time is after "when"'s current time. More...

virtual void	add (EDateFields field, int32_t amount, UErrorCode &status)
	UDate Arithmetic function. More...

virtual void	add (UCalendarDateFields field, int32_t amount, UErrorCode &status)
	UDate Arithmetic function. More...

void	roll (EDateFields field, UBool up, UErrorCode &status)
	Time Field Rolling function. More...

void	roll (UCalendarDateFields field, UBool up, UErrorCode &status)
	Time Field Rolling function. More...

virtual int32_t	fieldDifference (UDate when, EDateFields field, UErrorCode &status)
	Return the difference between the given time and the time this calendar object is set to. More...

virtual int32_t	fieldDifference (UDate when, UCalendarDateFields field, UErrorCode &status)
	Return the difference between the given time and the time this calendar object is set to. More...

void	adoptTimeZone (TimeZone *value)
	Sets the calendar's time zone to be the one passed in. More...

void	setTimeZone (const TimeZone &zone)
	Sets the calendar's time zone to be the same as the one passed in. More...

const TimeZone &	getTimeZone () const
	Returns a reference to the time zone owned by this calendar. More...

TimeZone *	orphanTimeZone ()
	Returns the time zone owned by this calendar. More...

virtual UBool	inDaylightTime (UErrorCode &status) const
	Queries if the current date for this Calendar is in Daylight Savings Time. More...

void	setLenient (UBool lenient)
	Specifies whether or not date/time interpretation is to be lenient. More...

UBool	isLenient () const
	Tells whether date/time interpretation is to be lenient. More...

void	setRepeatedWallTimeOption (UCalendarWallTimeOption option)
	Sets the behavior for handling wall time repeating multiple times at negative time zone offset transitions. More...

UCalendarWallTimeOption	getRepeatedWallTimeOption () const
	Gets the behavior for handling wall time repeating multiple times at negative time zone offset transitions. More...

void	setSkippedWallTimeOption (UCalendarWallTimeOption option)
	Sets the behavior for handling skipped wall time at positive time zone offset transitions. More...

UCalendarWallTimeOption	getSkippedWallTimeOption () const
	Gets the behavior for handling skipped wall time at positive time zone offset transitions. More...

void	setFirstDayOfWeek (UCalendarDaysOfWeek value)
	Sets what the first day of the week is; e.g., Sunday in US, Monday in France. More...

EDaysOfWeek	getFirstDayOfWeek () const
	Gets what the first day of the week is; e.g., Sunday in US, Monday in France. More...

UCalendarDaysOfWeek	getFirstDayOfWeek (UErrorCode &status) const
	Gets what the first day of the week is; e.g., Sunday in US, Monday in France. More...

void	setMinimalDaysInFirstWeek (uint8_t value)
	Sets what the minimal days required in the first week of the year are; For example, if the first week is defined as one that contains the first day of the first month of a year, call the method with value 1. More...

uint8_t	getMinimalDaysInFirstWeek () const
	Gets what the minimal days required in the first week of the year are; e.g., if the first week is defined as one that contains the first day of the first month of a year, getMinimalDaysInFirstWeek returns 1. More...

virtual int32_t	getMinimum (EDateFields field) const
	Gets the minimum value for the given time field. More...

virtual int32_t	getMinimum (UCalendarDateFields field) const
	Gets the minimum value for the given time field. More...

virtual int32_t	getMaximum (EDateFields field) const
	Gets the maximum value for the given time field. More...

virtual int32_t	getMaximum (UCalendarDateFields field) const
	Gets the maximum value for the given time field. More...

virtual int32_t	getGreatestMinimum (EDateFields field) const
	Gets the highest minimum value for the given field if varies. More...

virtual int32_t	getGreatestMinimum (UCalendarDateFields field) const
	Gets the highest minimum value for the given field if varies. More...

virtual int32_t	getLeastMaximum (EDateFields field) const
	Gets the lowest maximum value for the given field if varies. More...

virtual int32_t	getLeastMaximum (UCalendarDateFields field) const
	Gets the lowest maximum value for the given field if varies. More...

int32_t	getActualMinimum (EDateFields field, UErrorCode &status) const
	Return the minimum value that this field could have, given the current date. More...

int32_t	get (UCalendarDateFields field, UErrorCode &status) const
	Gets the value for a given time field. More...

UBool	isSet (UCalendarDateFields field) const
	Determines if the given time field has a value set. More...

void	set (UCalendarDateFields field, int32_t value)
	Sets the given time field with the given value. More...

void	set (int32_t year, int32_t month, int32_t date)
	Sets the values for the fields YEAR, MONTH, and DATE. More...

void	set (int32_t year, int32_t month, int32_t date, int32_t hour, int32_t minute)
	Sets the values for the fields YEAR, MONTH, DATE, HOUR_OF_DAY, and MINUTE. More...

void	set (int32_t year, int32_t month, int32_t date, int32_t hour, int32_t minute, int32_t second)
	Sets the values for the fields YEAR, MONTH, DATE, HOUR_OF_DAY, MINUTE, and SECOND. More...

void	clear ()
	Clears the values of all the time fields, making them both unset and assigning them a value of zero. More...

void	clear (UCalendarDateFields field)
	Clears the value in the given time field, both making it unset and assigning it a value of zero. More...

virtual UCalendarWeekdayType	getDayOfWeekType (UCalendarDaysOfWeek dayOfWeek, UErrorCode &status) const
	Returns whether the given day of the week is a weekday, a weekend day, or a day that transitions from one to the other, for the locale and calendar system associated with this Calendar (the locale's region is often the most determinant factor). More...

virtual int32_t	getWeekendTransition (UCalendarDaysOfWeek dayOfWeek, UErrorCode &status) const
	Returns the time during the day at which the weekend begins or ends in this calendar system. More...

virtual UBool	isWeekend (UDate date, UErrorCode &status) const
	Returns true if the given UDate is in the weekend in this calendar system. More...

virtual UBool	isWeekend () const
	Returns true if this Calendar's current date-time is in the weekend in this calendar system. More...

virtual bool	inTemporalLeapYear (UErrorCode &status) const
	Returns true if the date is in a leap year. More...

virtual const char *	getTemporalMonthCode (UErrorCode &status) const
	Gets The Temporal monthCode value corresponding to the month for the date. More...

virtual void	setTemporalMonthCode (const char *temporalMonth, UErrorCode &status)
	Sets The Temporal monthCode which is a string identifier that starts with the literal grapheme "M" followed by two graphemes representing the zero-padded month number of the current month in a normal (non-leap) year and suffixed by an optional literal grapheme "L" if this is a leap month in a lunisolar calendar. More...

virtual UBool	haveDefaultCentury () const =0

virtual UDate	defaultCenturyStart () const =0

virtual int32_t	defaultCenturyStartYear () const =0

Locale	getLocale (ULocDataLocaleType type, UErrorCode &status) const
	Get the locale for this calendar object. More...

virtual int32_t	getRelatedYear (UErrorCode &status) const

virtual void	setRelatedYear (int32_t year)

const char *	getLocaleID (ULocDataLocaleType type, UErrorCode &status) const
	Get the locale for this calendar object. More...

Public Member Functions inherited from icu::UObject
virtual	~UObject ()
	Destructor. More...

Static Public Member Functions
static UClassID	getStaticClassID ()
	Return the class ID for this class. More...

Static Public Member Functions inherited from icu::Calendar
static Calendar *	createInstance (UErrorCode &success)
	Creates a Calendar using the default timezone and locale. More...

static Calendar *	createInstance (TimeZone *zoneToAdopt, UErrorCode &success)
	Creates a Calendar using the given timezone and the default locale. More...

static Calendar *	createInstance (const TimeZone &zone, UErrorCode &success)
	Creates a Calendar using the given timezone and the default locale. More...

static Calendar *	createInstance (const Locale &aLocale, UErrorCode &success)
	Creates a Calendar using the default timezone and the given locale. More...

static Calendar *	createInstance (TimeZone *zoneToAdopt, const Locale &aLocale, UErrorCode &success)
	Creates a Calendar using the given timezone and given locale. More...

static Calendar *	createInstance (const TimeZone &zone, const Locale &aLocale, UErrorCode &success)
	Gets a Calendar using the given timezone and given locale. More...

static const Locale *	getAvailableLocales (int32_t &count)
	Returns a list of the locales for which Calendars are installed. More...

static StringEnumeration *	getKeywordValuesForLocale (const char *key, const Locale &locale, UBool commonlyUsed, UErrorCode &status)
	Given a key and a locale, returns an array of string values in a preferred order that would make a difference. More...

static UDate	getNow ()
	Returns the current UTC (GMT) time measured in milliseconds since 0:00:00 on 1/1/70 (derived from the system time). More...

static StringEnumeration *	getAvailableLocales ()
	INTERNAL FOR 2.6 – Registration. More...

static URegistryKey	registerFactory (ICUServiceFactory *toAdopt, UErrorCode &status)
	Register a new Calendar factory. More...

static UBool	unregister (URegistryKey key, UErrorCode &status)
	Unregister a previously-registered CalendarFactory using the key returned from the register call. More...

static Calendar *	makeInstance (const Locale &locale, UErrorCode &status)
	Creates a new Calendar from a Locale for the cache. More...

static void	getCalendarTypeFromLocale (const Locale &locale, char *typeBuffer, int32_t typeBufferSize, UErrorCode &status)
	Get the calendar type for given locale. More...

Protected Member Functions
virtual int32_t	internalGetEra () const
	Return the ERA. More...

virtual int64_t	handleComputeMonthStart (int32_t eyear, int32_t month, UBool useMonth, UErrorCode &status) const override
	Return the Julian day number of day before the first day of the given month in the given extended year. More...

virtual int32_t	handleComputeJulianDay (UCalendarDateFields bestField, UErrorCode &status) override
	Subclasses may override this. More...

virtual int32_t	handleGetMonthLength (int32_t extendedYear, int32_t month, UErrorCode &status) const override
	Return the number of days in the given month of the given extended year of this calendar system. More...

virtual int32_t	handleGetYearLength (int32_t eyear, UErrorCode &status) const override
	Return the number of days in the given extended year of this calendar system. More...

virtual int32_t	monthLength (int32_t month, UErrorCode &status) const
	return the length of the given month. More...

virtual int32_t	monthLength (int32_t month, int32_t year) const
	return the length of the month according to the given year. More...

int32_t	yearLength () const
	return the length of the year field. More...

virtual UDate	getEpochDay (UErrorCode &status)
	Return the day number with respect to the epoch. More...

virtual int32_t	handleGetLimit (UCalendarDateFields field, ELimitType limitType) const override
	Subclass API for defining limits of different types. More...

virtual int32_t	handleGetExtendedYear (UErrorCode &status) override
	Return the extended year defined by the current fields. More...

virtual int32_t	handleGetExtendedYearFromWeekFields (int32_t yearWoy, int32_t woy, UErrorCode &status) override
	Subclasses may override this to convert from week fields (YEAR_WOY and WEEK_OF_YEAR) to an extended year in the case where YEAR, EXTENDED_YEAR are not set. More...

virtual void	handleComputeFields (int32_t julianDay, UErrorCode &status) override
	Subclasses may override this method to compute several fields specific to each calendar system. More...

virtual bool	isEra0CountingBackward () const override
	The year in this calendar is counting from 1 backward if the era is 0. More...

Protected Member Functions inherited from icu::Calendar
	Calendar (UErrorCode &success)
	Constructs a Calendar with the default time zone as returned by TimeZone::createInstance(), and the default locale. More...

	Calendar (const Calendar &source)
	Copy constructor. More...

Calendar &	operator= (const Calendar &right)
	Default assignment operator. More...

	Calendar (TimeZone *zone, const Locale &aLocale, UErrorCode &success)
	Constructs a Calendar with the given time zone and locale. More...

	Calendar (const TimeZone &zone, const Locale &aLocale, UErrorCode &success)
	Constructs a Calendar with the given time zone and locale. More...

virtual void	computeTime (UErrorCode &status)
	Converts Calendar's time field values to GMT as milliseconds. More...

virtual void	computeFields (UErrorCode &status)
	Converts GMT as milliseconds to time field values. More...

double	getTimeInMillis (UErrorCode &status) const
	Gets this Calendar's current time as a long. More...

void	setTimeInMillis (double millis, UErrorCode &status)
	Sets this Calendar's current time from the given long value. More...

void	complete (UErrorCode &status)
	Recomputes the current time from currently set fields, and then fills in any unset fields in the time field list. More...

int32_t	internalGet (EDateFields field) const
	Gets the value for a given time field. More...

int32_t	internalGet (UCalendarDateFields field, int32_t defaultValue) const
	Gets the value for a given time field. More...

int32_t	internalGet (UCalendarDateFields field) const
	Gets the value for a given time field. More...

virtual int32_t	internalGetMonth (UErrorCode &status) const
	Use this function instead of internalGet(UCAL_MONTH). More...

virtual int32_t	internalGetMonth (int32_t defaultValue, UErrorCode &status) const
	Use this function instead of internalGet(UCAL_MONTH, defaultValue). More...

void	internalSet (EDateFields field, int32_t value)
	Sets the value for a given time field. More...

void	internalSet (UCalendarDateFields field, int32_t value)
	Sets the value for a given time field. More...

virtual void	prepareGetActual (UCalendarDateFields field, UBool isMinimum, UErrorCode &status)
	Prepare this calendar for computing the actual minimum or maximum. More...

virtual int32_t	getLimit (UCalendarDateFields field, ELimitType limitType) const
	Return a limit for a field. More...

virtual void	validateField (UCalendarDateFields field, UErrorCode &status)
	Validate a single field of this calendar. More...

int32_t	computeJulianDay (UErrorCode &status)
	Compute the Julian day from fields. More...

double	computeMillisInDay ()
	Compute the milliseconds in the day from the fields. More...

int32_t	computeZoneOffset (double millis, double millisInDay, UErrorCode &ec)
	This method can assume EXTENDED_YEAR has been set. More...

int32_t	newestStamp (UCalendarDateFields start, UCalendarDateFields end, int32_t bestSoFar) const
	Determine the best stamp in a range. More...

UCalendarDateFields	resolveFields (const UFieldResolutionTable *precedenceTable) const
	Given a precedence table, return the newest field combination in the table, or UCAL_FIELD_COUNT if none is found. More...

virtual const UFieldResolutionTable *	getFieldResolutionTable () const

UCalendarDateFields	newerField (UCalendarDateFields defaultField, UCalendarDateFields alternateField) const
	Return the field that is newer, either defaultField, or alternateField. More...

UDate	internalGetTime () const
	Get the current time without recomputing. More...

void	internalSetTime (UDate time)
	Set the current time without affecting flags or fields. More...

int32_t	getGregorianYear () const
	Return the extended year on the Gregorian calendar as computed by `computeGregorianFields()`. More...

int32_t	getGregorianMonth () const
	Return the month (0-based) on the Gregorian calendar as computed by `computeGregorianFields()`. More...

int32_t	getGregorianDayOfYear () const
	Return the day of year (1-based) on the Gregorian calendar as computed by `computeGregorianFields()`. More...

int32_t	getGregorianDayOfMonth () const
	Return the day of month (1-based) on the Gregorian calendar as computed by `computeGregorianFields()`. More...

virtual int32_t	getDefaultMonthInYear (int32_t eyear, UErrorCode &status)
	Called by computeJulianDay. More...

virtual int32_t	getDefaultDayInMonth (int32_t eyear, int32_t month, UErrorCode &status)
	Called by computeJulianDay. More...

virtual void	pinField (UCalendarDateFields field, UErrorCode &status)
	Adjust the specified field so that it is within the allowable range for the date to which this calendar is set. More...

int32_t	weekNumber (int32_t desiredDay, int32_t dayOfPeriod, int32_t dayOfWeek)
	Return the week number of a day, within a period. More...

int32_t	weekNumber (int32_t dayOfPeriod, int32_t dayOfWeek)
	Return the week number of a day, within a period. More...

int32_t	getLocalDOW (UErrorCode &status)
	returns the local DOW, valid range 0..6 More...

void	computeGregorianFields (int32_t julianDay, UErrorCode &ec)
	Compute the Gregorian calendar year, month, and day of month from the Julian day. More...

Additional Inherited Members
Protected Types inherited from icu::Calendar
enum	ELimitType { UCAL_LIMIT_MINIMUM = 0 , UCAL_LIMIT_GREATEST_MINIMUM , UCAL_LIMIT_LEAST_MAXIMUM , UCAL_LIMIT_MAXIMUM , UCAL_LIMIT_COUNT }
	Limit enums. More...

enum	{ kUnset = 0 , kInternallySet , kMinimumUserStamp }
	Special values of stamp[]. More...

Static Protected Member Functions inherited from icu::Calendar
static uint8_t	julianDayToDayOfWeek (int32_t julian)
	Convert a quasi Julian date to the day of the week. More...

Protected Attributes inherited from icu::Calendar
int32_t	fFields [UCAL_FIELD_COUNT]
	The time fields containing values into which the millis is computed. More...

Static Protected Attributes inherited from icu::Calendar
static constexpr int32_t	kResolveSTOP = -1
	Marker for end of resolve set (row or group). More...

static constexpr int32_t	kResolveRemap = 32
	Value to be bitwised "ORed" against resolve table field values for remapping. More...

static const UFieldResolutionTable	kDatePrecedence []
	Precedence table for Dates. More...

static const UFieldResolutionTable	kYearPrecedence []
	Precedence table for Year. More...

static const UFieldResolutionTable	kDOWPrecedence []
	Precedence table for Day of Week. More...

static const UFieldResolutionTable	kMonthPrecedence []
	Precedence table for Months. More...

Detailed Description

Concrete class which provides the standard calendar used by most of the world.

The standard (Gregorian) calendar has 2 eras, BC and AD.

This implementation handles a single discontinuity, which corresponds by default to the date the Gregorian calendar was originally instituted (October 15, 1582). Not all countries adopted the Gregorian calendar then, so this cutover date may be changed by the caller.

Prior to the institution of the Gregorian Calendar, New Year's Day was March 25. To avoid confusion, this Calendar always uses January 1. A manual adjustment may be made if desired for dates that are prior to the Gregorian changeover and which fall between January 1 and March 24.

Values calculated for the WEEK_OF_YEAR field range from 1 to

Week 1 for a year is the first week that contains at least getMinimalDaysInFirstWeek() days from that year. It thus depends on the values of getMinimalDaysInFirstWeek(), getFirstDayOfWeek(), and the day of the week of January 1. Weeks between week 1 of one year and week 1 of the following year are numbered sequentially from 2 to 52 or 53 (as needed).

For example, January 1, 1998 was a Thursday. If getFirstDayOfWeek() is MONDAY and getMinimalDaysInFirstWeek() is 4 (these are the values reflecting ISO 8601 and many national standards), then week 1 of 1998 starts on December 29, 1997, and ends on January 4, 1998. If, however, getFirstDayOfWeek() is SUNDAY, then week 1 of 1998 starts on January 4, 1998, and ends on January 10, 1998; the first three days of 1998 then are part of week 53 of 1997.

Example for using GregorianCalendar:

// get the supported ids for GMT-08:00 (Pacific Standard Time)
UErrorCode success = U_ZERO_ERROR;
const StringEnumeration *ids = TimeZone::createEnumeration(-8 * 60 * 60 * 1000, success);
// if no ids were returned, something is wrong. get out.
if (U_FAILURE(success)) {
    return;
}
 
// begin output
cout << "Current Time" << endl;
 
// create a Pacific Standard Time time zone
SimpleTimeZone* pdt = new SimpleTimeZone(-8 * 60 * 60 * 1000, ids->unext(nullptr, success)));
 
// set up rules for daylight savings time
pdt->setStartRule(UCAL_MARCH, 1, UCAL_SUNDAY, 2 * 60 * 60 * 1000);
pdt->setEndRule(UCAL_NOVEMBER, 2, UCAL_SUNDAY, 2 * 60 * 60 * 1000);
 
// create a GregorianCalendar with the Pacific Daylight time zone
// and the current date and time
Calendar* calendar = new GregorianCalendar( pdt, success );
 
// print out a bunch of interesting things
cout << "ERA: " << calendar->get( UCAL_ERA, success ) << endl;
cout << "YEAR: " << calendar->get( UCAL_YEAR, success ) << endl;
cout << "MONTH: " << calendar->get( UCAL_MONTH, success ) << endl;
cout << "WEEK_OF_YEAR: " << calendar->get( UCAL_WEEK_OF_YEAR, success ) << endl;
cout << "WEEK_OF_MONTH: " << calendar->get( UCAL_WEEK_OF_MONTH, success ) << endl;
cout << "DATE: " << calendar->get( UCAL_DATE, success ) << endl;
cout << "DAY_OF_MONTH: " << calendar->get( UCAL_DAY_OF_MONTH, success ) << endl;
cout << "DAY_OF_YEAR: " << calendar->get( UCAL_DAY_OF_YEAR, success ) << endl;
cout << "DAY_OF_WEEK: " << calendar->get( UCAL_DAY_OF_WEEK, success ) << endl;
cout << "DAY_OF_WEEK_IN_MONTH: " << calendar->get( UCAL_DAY_OF_WEEK_IN_MONTH, success ) << endl;
cout << "AM_PM: " << calendar->get( UCAL_AM_PM, success ) << endl;
cout << "HOUR: " << calendar->get( UCAL_HOUR, success ) << endl;
cout << "HOUR_OF_DAY: " << calendar->get( UCAL_HOUR_OF_DAY, success ) << endl;
cout << "MINUTE: " << calendar->get( UCAL_MINUTE, success ) << endl;
cout << "SECOND: " << calendar->get( UCAL_SECOND, success ) << endl;
cout << "MILLISECOND: " << calendar->get( UCAL_MILLISECOND, success ) << endl;
cout << "ZONE_OFFSET: " << (calendar->get( UCAL_ZONE_OFFSET, success )/(60*60*1000)) << endl;
cout << "DST_OFFSET: " << (calendar->get( UCAL_DST_OFFSET, success )/(60*60*1000)) << endl;
 
cout << "Current Time, with hour reset to 3" << endl;
calendar->clear(UCAL_HOUR_OF_DAY); // so doesn't override
calendar->set(UCAL_HOUR, 3);
cout << "ERA: " << calendar->get( UCAL_ERA, success ) << endl;
cout << "YEAR: " << calendar->get( UCAL_YEAR, success ) << endl;
cout << "MONTH: " << calendar->get( UCAL_MONTH, success ) << endl;
cout << "WEEK_OF_YEAR: " << calendar->get( UCAL_WEEK_OF_YEAR, success ) << endl;
cout << "WEEK_OF_MONTH: " << calendar->get( UCAL_WEEK_OF_MONTH, success ) << endl;
cout << "DATE: " << calendar->get( UCAL_DATE, success ) << endl;
cout << "DAY_OF_MONTH: " << calendar->get( UCAL_DAY_OF_MONTH, success ) << endl;
cout << "DAY_OF_YEAR: " << calendar->get( UCAL_DAY_OF_YEAR, success ) << endl;
cout << "DAY_OF_WEEK: " << calendar->get( UCAL_DAY_OF_WEEK, success ) << endl;
cout << "DAY_OF_WEEK_IN_MONTH: " << calendar->get( UCAL_DAY_OF_WEEK_IN_MONTH, success ) << endl;
cout << "AM_PM: " << calendar->get( UCAL_AM_PM, success ) << endl;
cout << "HOUR: " << calendar->get( UCAL_HOUR, success ) << endl;
cout << "HOUR_OF_DAY: " << calendar->get( UCAL_HOUR_OF_DAY, success ) << endl;
cout << "MINUTE: " << calendar->get( UCAL_MINUTE, success ) << endl;
cout << "SECOND: " << calendar->get( UCAL_SECOND, success ) << endl;
cout << "MILLISECOND: " << calendar->get( UCAL_MILLISECOND, success ) << endl;
cout << "ZONE_OFFSET: " << (calendar->get( UCAL_ZONE_OFFSET, success )/(60*60*1000)) << endl; // in hours
cout << "DST_OFFSET: " << (calendar->get( UCAL_DST_OFFSET, success )/(60*60*1000)) << endl; // in hours
 
if (U_FAILURE(success)) {
    cout << "An error occurred. success=" << u_errorName(success) << endl;
}
 
delete ids;
delete calendar; // also deletes pdt
icu::Calendar::Calendar
Calendar(UErrorCode &success)
Constructs a Calendar with the default time zone as returned by TimeZone::createInstance(),...
icu::GregorianCalendar::GregorianCalendar
GregorianCalendar(UErrorCode &success)
Constructs a default GregorianCalendar using the current time in the default time zone with the defau...
icu::TimeZone::createEnumeration
static StringEnumeration * createEnumeration()
Returns an enumeration over all recognized time zone IDs.
UCAL_HOUR_OF_DAY
@ UCAL_HOUR_OF_DAY
Field number indicating the hour of the day.
Definition: ucal.h:351
UCAL_ERA
@ UCAL_ERA
Field number indicating the era, e.g., AD or BC in the Gregorian (Julian) calendar.
Definition: ucal.h:208
UCAL_WEEK_OF_MONTH
@ UCAL_WEEK_OF_MONTH
Field number indicating the week number within the current month.
Definition: ucal.h:263
UCAL_YEAR
@ UCAL_YEAR
Field number indicating the year.
Definition: ucal.h:214
UCAL_DAY_OF_YEAR
@ UCAL_DAY_OF_YEAR
Field number indicating the day number within the current year.
Definition: ucal.h:279
UCAL_MINUTE
@ UCAL_MINUTE
Field number indicating the minute within the hour.
Definition: ucal.h:359
UCAL_DATE
@ UCAL_DATE
Field number indicating the day of the month.
Definition: ucal.h:272
UCAL_SECOND
@ UCAL_SECOND
Field number indicating the second within the minute.
Definition: ucal.h:367
UCAL_DAY_OF_WEEK_IN_MONTH
@ UCAL_DAY_OF_WEEK_IN_MONTH
Field number indicating the ordinal number of the day of the week within the current month.
Definition: ucal.h:320
UCAL_MONTH
@ UCAL_MONTH
Field number indicating the month.
Definition: ucal.h:235
UCAL_ZONE_OFFSET
@ UCAL_ZONE_OFFSET
Field number indicating the raw offset from GMT in milliseconds.
Definition: ucal.h:382
UCAL_WEEK_OF_YEAR
@ UCAL_WEEK_OF_YEAR
Field number indicating the week number within the current year.
Definition: ucal.h:248
UCAL_MILLISECOND
@ UCAL_MILLISECOND
Field number indicating the millisecond within the second.
Definition: ucal.h:375
UCAL_HOUR
@ UCAL_HOUR
Field number indicating the hour of the morning or afternoon.
Definition: ucal.h:342
UCAL_DAY_OF_MONTH
@ UCAL_DAY_OF_MONTH
Field number indicating the day of the month.
Definition: ucal.h:489
UCAL_DAY_OF_WEEK
@ UCAL_DAY_OF_WEEK
Field number indicating the day of the week.
Definition: ucal.h:295
UCAL_AM_PM
@ UCAL_AM_PM
Field number indicating whether the HOUR is before or after noon.
Definition: ucal.h:331
UCAL_DST_OFFSET
@ UCAL_DST_OFFSET
Field number indicating the daylight savings offset in milliseconds.
Definition: ucal.h:389
UCAL_SUNDAY
@ UCAL_SUNDAY
Sunday.
Definition: ucal.h:504
UCAL_NOVEMBER
@ UCAL_NOVEMBER
November.
Definition: ucal.h:547
UCAL_MARCH
@ UCAL_MARCH
March.
Definition: ucal.h:531
u_errorName
U_CAPI const char * u_errorName(UErrorCode code)
Return a string for a UErrorCode value.
UErrorCode
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
Definition: utypes.h:430
U_ZERO_ERROR
@ U_ZERO_ERROR
No error, no warning.
Definition: utypes.h:465
U_FAILURE
#define U_FAILURE(x)
Does the error code indicate a failure?
Definition: utypes.h:748

Stable:: ICU 2.0

Definition at line 153 of file gregocal.h.

Member Enumeration Documentation

◆ EEras

enum

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ EEras