Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/classicu_1_1GregorianCalendar.html below:

ICU 77.1: icu::GregorianCalendar Class Reference

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

#include <gregocal.h>

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

1. 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:

    return;
}


cout << "Current Time" << endl;


SimpleTimeZone* pdt = new SimpleTimeZone(-8 * 60 * 60 * 1000, ids->unext(nullptr, success)));










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 << 
"DATE: "
 << calendar->get( 
UCAL_DATE
, success ) << endl;




cout << 
"AM_PM: "
 << calendar->get( 
UCAL_AM_PM
, success ) << endl;
cout << 
"HOUR: "
 << calendar->get( 
UCAL_HOUR
, success ) << endl;

cout << 
"MINUTE: "
 << calendar->get( 
UCAL_MINUTE
, success ) << endl;
cout << 
"SECOND: "
 << calendar->get( 
UCAL_SECOND
, 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;


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 << 
"DATE: "
 << calendar->get( 
UCAL_DATE
, success ) << endl;




cout << 
"AM_PM: "
 << calendar->get( 
UCAL_AM_PM
, success ) << endl;
cout << 
"HOUR: "
 << calendar->get( 
UCAL_HOUR
, success ) << endl;

cout << 
"MINUTE: "
 << calendar->get( 
UCAL_MINUTE
, success ) << endl;
cout << 
"SECOND: "
 << calendar->get( 
UCAL_SECOND
, 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 << 
"An error occurred. success="
 << 
u_errorName
(success) << endl;
}

delete ids;
delete calendar; 
Calendar(UErrorCode &success)
Constructs a Calendar with the default time zone as returned by TimeZone::createInstance(),...
GregorianCalendar(UErrorCode &success)
Constructs a default GregorianCalendar using the current time in the default time zone with the defau...
static StringEnumeration * createEnumeration()
Returns an enumeration over all recognized time zone IDs.
@ UCAL_HOUR_OF_DAY
Field number indicating the hour of the day.
@ UCAL_ERA
Field number indicating the era, e.g., AD or BC in the Gregorian (Julian) calendar.
@ UCAL_WEEK_OF_MONTH
Field number indicating the week number within the current month.
@ UCAL_YEAR
Field number indicating the year.
@ UCAL_DAY_OF_YEAR
Field number indicating the day number within the current year.
@ UCAL_MINUTE
Field number indicating the minute within the hour.
@ UCAL_DATE
Field number indicating the day of the month.
@ UCAL_SECOND
Field number indicating the second within the minute.
@ UCAL_DAY_OF_WEEK_IN_MONTH
Field number indicating the ordinal number of the day of the week within the current month.
@ UCAL_MONTH
Field number indicating the month.
@ UCAL_ZONE_OFFSET
Field number indicating the raw offset from GMT in milliseconds.
@ UCAL_WEEK_OF_YEAR
Field number indicating the week number within the current year.
@ UCAL_MILLISECOND
Field number indicating the millisecond within the second.
@ UCAL_HOUR
Field number indicating the hour of the morning or afternoon.
@ UCAL_DAY_OF_MONTH
Field number indicating the day of the month.
@ UCAL_DAY_OF_WEEK
Field number indicating the day of the week.
@ UCAL_AM_PM
Field number indicating whether the HOUR is before or after noon.
@ UCAL_DST_OFFSET
Field number indicating the daylight savings offset in milliseconds.

@ UCAL_NOVEMBER
November.

U_CAPI const char * u_errorName(UErrorCode code)
Return a string for a UErrorCode value.
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
@ U_ZERO_ERROR
No error, no warning.
#define U_FAILURE(x)
Does the error code indicate a failure?

Stable:

ICU 2.0

Definition at line 153 of file gregocal.h.

Constructs a default GregorianCalendar using the current time in the default time zone with the default locale.

Parameters

success Indicates the status of GregorianCalendar object construction. Returns U_ZERO_ERROR if constructed successfully.

Stable:

ICU 2.0

Constructs a GregorianCalendar based on the current time in the given time zone with the default locale.

Clients are no longer responsible for deleting the given time zone object after it's adopted.

Parameters

zoneToAdopt The given timezone. success Indicates the status of GregorianCalendar object construction. Returns U_ZERO_ERROR if constructed successfully.

Stable:

ICU 2.0

Constructs a GregorianCalendar based on the current time in the given time zone with the default locale.

Parameters

zone The given timezone. success Indicates the status of GregorianCalendar object construction. Returns U_ZERO_ERROR if constructed successfully.

Stable:

ICU 2.0

Constructs a GregorianCalendar based on the current time in the default time zone with the given locale.

Parameters

aLocale The given locale. success Indicates the status of GregorianCalendar object construction. Returns U_ZERO_ERROR if constructed successfully.

Stable:

ICU 2.0

Constructs a GregorianCalendar based on the current time in the given time zone with the given locale.

Clients are no longer responsible for deleting the given time zone object after it's adopted.

Parameters

zoneToAdopt The given timezone. aLocale The given locale. success Indicates the status of GregorianCalendar object construction. Returns U_ZERO_ERROR if constructed successfully.

Stable:

ICU 2.0

Constructs a GregorianCalendar based on the current time in the given time zone with the given locale.

Parameters

zone The given timezone. aLocale The given locale. success Indicates the status of GregorianCalendar object construction. Returns U_ZERO_ERROR if constructed successfully.

Stable:

ICU 2.0

Constructs a GregorianCalendar with the given AD date set in the default time zone with the default locale.

Parameters

year The value used to set the YEAR time field in the calendar. month The value used to set the MONTH time field in the calendar. Month value is 0-based. e.g., 0 for January. date The value used to set the DATE time field in the calendar. success Indicates the status of GregorianCalendar object construction. Returns U_ZERO_ERROR if constructed successfully.

Stable:

ICU 2.0

Constructs a GregorianCalendar with the given AD date and time set for the default time zone with the default locale.

Parameters

year The value used to set the YEAR time field in the calendar. month The value used to set the MONTH time field in the calendar. Month value is 0-based. e.g., 0 for January. date The value used to set the DATE time field in the calendar. hour The value used to set the HOUR_OF_DAY time field in the calendar. minute The value used to set the MINUTE time field in the calendar. success Indicates the status of GregorianCalendar object construction. Returns U_ZERO_ERROR if constructed successfully.

Stable:

ICU 2.0

Constructs a GregorianCalendar with the given AD date and time set for the default time zone with the default locale.

Parameters

year The value used to set the YEAR time field in the calendar. month The value used to set the MONTH time field in the calendar. Month value is 0-based. e.g., 0 for January. date The value used to set the DATE time field in the calendar. hour The value used to set the HOUR_OF_DAY time field in the calendar. minute The value used to set the MINUTE time field in the calendar. second The value used to set the SECOND time field in the calendar. success Indicates the status of GregorianCalendar object construction. Returns U_ZERO_ERROR if constructed successfully.

Stable:

ICU 2.0

Copy constructor.

Parameters

source the object to be copied.

Stable:

ICU 2.0

Create and return a polymorphic copy of this calendar.

Returns

return a polymorphic copy of this calendar.

Stable:

ICU 2.0

Implements icu::Calendar.

Return the maximum value that this field could have, given the current date.

For example, with the date "Feb 3, 1997" and the DAY_OF_MONTH field, the actual maximum would be 28; for "Feb 3, 1996" it s 29. Similarly for a Hebrew calendar, for some years the actual maximum for MONTH is 12, and for others 13.

Parameters

field the time field. status returns any errors that may result from this function call.

Returns

the maximum value that this field could have, given the current date.

Stable:

ICU 2.6

Reimplemented from icu::Calendar.

Return the minimum value that this field could have, given the current date.

For the Gregorian calendar, this is the same as getMinimum() and getGreatestMinimum().

Parameters

Returns

the minimum value that this field could have, given the current date.

Deprecated:

ICU 2.6. Use getActualMinimum(UCalendarDateFields field) instead.

Return the minimum value that this field could have, given the current date.

For the Gregorian calendar, this is the same as getMinimum() and getGreatestMinimum().

Parameters

field the time field. status

Returns

the minimum value that this field could have, given the current date.

Deprecated:

ICU 2.6. Use getActualMinimum(UCalendarDateFields field) instead. (Added to ICU 3.0 for signature consistency)

Return the minimum value that this field could have, given the current date.

For the Gregorian calendar, this is the same as getMinimum() and getGreatestMinimum().

Parameters

field the time field. status error result.

Returns

the minimum value that this field could have, given the current date.

Stable:

ICU 3.0

Reimplemented from icu::Calendar.

Override Calendar 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 2.0

Implements icu::Calendar.

Return the day number with respect to the epoch.

January 1, 1970 (Gregorian) is day zero.

Parameters

status Fill-in parameter which receives the status of this operation.

Returns

the day number with respect to the epoch.

Internal:

Do not use. This API is for internal use only.

Gets the Gregorian Calendar change date.

This is the point when the switch from Julian dates to Gregorian dates occurred. Default is 00:00:00 local time, October 15, 1582. Previous to this time and date will be Julian dates.

Returns

The Gregorian cutover time for this calendar.

Stable:

ICU 2.0

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() ==
     Derived::getStaticClassID()) ...

Returns

The class ID for all objects of this class.

Stable:

ICU 2.0

Returns the calendar type name string for this Calendar object.

The returned string is the legacy ICU calendar attribute value, for example, "gregorian" or "japanese".

For more details see the Calendar::getType() documentation.

Returns

legacy calendar type name string

Stable:

ICU 49

Implements icu::Calendar.

Subclasses may override this method to compute several fields specific to each calendar system.

These are:

• ERA
• YEAR
• MONTH
• DAY_OF_MONTH
• DAY_OF_YEAR
• EXTENDED_YEAR

The GregorianCalendar implementation implements a calendar with the specified Julian/Gregorian cutover date.

Internal:

Do not use. This API is for internal use only.

Reimplemented from icu::Calendar.

Subclasses may override this.

This method calls handleGetMonthLength() to obtain the calendar-specific month length.

Parameters

bestField which field to use to calculate the date status Fill-in parameter which receives the status of this operation.

Returns

julian day specified by calendar fields.

Internal:

Do not use. This API is for internal use only.

Reimplemented from icu::Calendar.

Return the Julian day number of day before the first day of the given month in the given extended year.

Subclasses should override this method to implement their calendar system.

Parameters

eyear the extended year month the zero-based month, or 0 if useMonth is false useMonth if false, compute the day before the first day of the given year, otherwise, compute the day before the first day of the given month status Fill-in parameter which receives the status of this operation.

Returns

the Julian day number of the day before the first day of the given month and year

Internal:

Do not use. This API is for internal use only.

Implements icu::Calendar.

Return the extended year defined by the current fields.

This will use the UCAL_EXTENDED_YEAR field or the UCAL_YEAR and supra-year fields (such as UCAL_ERA) specific to the calendar system, depending on which set of fields is newer.

Parameters

Returns

the extended year

Internal:

Do not use. This API is for internal use only.

Implements icu::Calendar.

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.

The Gregorian implementation assumes a yearWoy in gregorian format, according to the current era.

Returns

the extended year, UCAL_EXTENDED_YEAR

Internal:

Do not use. This API is for internal use only.

Reimplemented from icu::Calendar.

Subclass API for defining limits of different types.

Subclasses must implement this method to return limits for the following fields:

UCAL_ERA
UCAL_YEAR
UCAL_MONTH
UCAL_WEEK_OF_YEAR
UCAL_WEEK_OF_MONTH
UCAL_DATE (DAY_OF_MONTH on Java)
UCAL_DAY_OF_YEAR
UCAL_DAY_OF_WEEK_IN_MONTH
UCAL_YEAR_WOY
UCAL_EXTENDED_YEAR

Parameters

field one of the above field numbers limitType one of MINIMUM, GREATEST_MINIMUM, LEAST_MAXIMUM, or MAXIMUM

Internal:

Do not use. This API is for internal use only.

Implements icu::Calendar.

Return the number of days in the given month of the given extended year of this calendar system.

Subclasses should override this method if they can provide a more correct or more efficient implementation than the default implementation in Calendar.

Internal:

Do not use. This API is for internal use only.

Reimplemented from icu::Calendar.

Return the number of days in the given extended year of this calendar system.

Subclasses should override this method if they can provide a more correct or more efficient implementation than the default implementation in Calendar.

Stable:

ICU 2.0

Reimplemented from icu::Calendar.

Return the ERA.

We need a special method for this because the default ERA is AD, but a zero (unset) ERA is BC.

Returns

the ERA.

Internal:

Do not use. This API is for internal use only.

The year in this calendar is counting from 1 backward if the era is 0.

Returns

The year in era 0 of this calendar is counting backward from 1.

Internal:

Do not use. This API is for internal use only.

Reimplemented from icu::Calendar.

Definition at line 628 of file gregocal.h.

Return true if the given year is a leap year.

Determination of whether a year is a leap year is actually very complicated. We do something crude and mostly correct here, but for a real determination you need a lot of contextual information. For example, in Sweden, the change from Julian to Gregorian happened in a complex way resulting in missed leap years and double leap years between 1700 and 1753. Another example is that after the start of the Julian calendar in 45 B.C., the leap years did not regularize until 8 A.D. This method ignores these quirks, and pays attention only to the Julian onset date and the Gregorian cutover (which can be changed).

Parameters

Returns

True if the given year is a leap year; false otherwise.

Stable:

ICU 2.0

return the length of the month according to the given year.

Parameters

month the given month. year the given year.

Returns

the length of the month

Internal:

Do not use. This API is for internal use only.

return the length of the given month.

Parameters

month the given month. status Fill-in parameter which receives the status of this operation.

Returns

the length of the given month.

Internal:

Do not use. This API is for internal use only.

Default assignment operator.

Parameters

right the object to be copied.

Stable:

ICU 2.0

(Overrides Calendar) Rolls up or down by the given amount in the specified field.

For more information, see the documentation for Calendar::roll().

Parameters

field The time field. amount Indicates amount to roll. status Output param set to success/failure code on exit. If any value previously set in the time field is invalid, this will be set to an error status.

Stable:

ICU 2.6.

Reimplemented from icu::Calendar.

Sets the GregorianCalendar change date.

This is the point when the switch from Julian dates to Gregorian dates occurred. Default is 00:00:00 local time, October 15, 1582. Previous to this time and date will be Julian dates.

Parameters

date The given Gregorian cutover date. success Output param set to success/failure code on exit.

Stable:

ICU 2.0

return the length of the year field.

Returns

the length of the year field

Internal:

Do not use. This API is for internal use only.

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

• i18n/unicode/gregocal.h

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4