since: 1.6 -

since: 1.6 -

since: 1.6 -

Also see:

GregorianCalendar#AD
GregorianCalendar#BC

Also see:

JANUARY
FEBRUARY
MARCH
APRIL
MAY
JUNE
JULY
AUGUST
SEPTEMBER
OCTOBER
NOVEMBER
DECEMBER
UNDECIMBER

Also see:

getFirstDayOfWeek
getMinimalDaysInFirstWeek

Also see:

getFirstDayOfWeek
getMinimalDaysInFirstWeek

Also see:

DAY_OF_MONTH

Also see:

DATE

Also see:

SUNDAY
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY

Also see:

DAY_OF_WEEK
WEEK_OF_MONTH

Also see:

AM
PM
HOUR

Also see:

AM_PM
HOUR_OF_DAY

Also see:

HOUR

 protected Calendar() 
{
        this(TimeZone.getDefault(), Locale.getDefault());
}

Constructs a {@code Calendar} instance using the default {@code TimeZone} and {@code Locale}.

 Calendar(TimeZone timezone) 
{
        fields = new int[FIELD_COUNT];
        isSet = new boolean[FIELD_COUNT];
        areFieldsSet = isTimeSet = false;
        setLenient(true);
        setTimeZone(timezone);
}

 protected Calendar(TimeZone timezone,
    Locale locale) 
{
        this(timezone);
        com.ibm.icu.util.Calendar icuCalendar = com.ibm.icu.util.Calendar
                .getInstance(com.ibm.icu.util.SimpleTimeZone
                        .getTimeZone(timezone.getID()), locale);
        setFirstDayOfWeek(icuCalendar.getFirstDayOfWeek());
        setMinimalDaysInFirstWeek(icuCalendar.getMinimalDaysInFirstWeek());
}

Constructs a {@code Calendar} instance using the specified {@code TimeZone} and {@code Locale}.

Parameters:

timezone - the timezone.

locale - the locale.

 abstract public  void add(int field,
    int value)
Adds the specified amount to a {@code Calendar} field.

 public boolean after(Object calendar) 
{
        if (!(calendar instanceof Calendar)) {
            return false;
        }
        return getTimeInMillis()  > ((Calendar) calendar).getTimeInMillis();
}

Returns whether the {@code Date} specified by this {@code Calendar} instance is after the {@code Date} specified by the parameter. The comparison is not dependent on the time zones of the {@code Calendar}.

 public boolean before(Object calendar) 
{
        if (!(calendar instanceof Calendar)) {
            return false;
        }
        return getTimeInMillis() <  ((Calendar) calendar).getTimeInMillis();
}

Returns whether the {@code Date} specified by this {@code Calendar} instance is before the {@code Date} specified by the parameter. The comparison is not dependent on the time zones of the {@code Calendar}.

 public final  void clear() 
{
        for (int i = 0; i <  FIELD_COUNT; i++) {
            fields[i] = 0;
            isSet[i] = false;
        }
        areFieldsSet = isTimeSet = false;
}

Clears all of the fields of this {@code Calendar}. All fields are initialized to zero.

 public final  void clear(int field) 
{
        fields[field] = 0;
        isSet[field] = false;
        areFieldsSet = isTimeSet = false;
}

Clears the specified field to zero and sets the isSet flag to {@code false}.

 public Object clone() 
{
        try {
            Calendar clone = (Calendar) super.clone();
            clone.fields = fields.clone();
            clone.isSet = isSet.clone();
            clone.zone = (TimeZone) zone.clone();
            return clone;
        } catch (CloneNotSupportedException e) {
            return null;
        }
}

Returns a new {@code Calendar} with the same properties.

 public int compareTo(Calendar anotherCalendar) 
{
        if (null == anotherCalendar) {
            throw new NullPointerException();
        }
        long timeInMillis = getTimeInMillis();
        long anotherTimeInMillis = anotherCalendar.getTimeInMillis();
        if (timeInMillis  > anotherTimeInMillis) {
            return 1;
        }
        if (timeInMillis == anotherTimeInMillis) {
            return 0;
        }
        return -1;
}

Compares the times of the two {@code Calendar}, which represent the milliseconds from the January 1, 1970 00:00:00.000 GMT (Gregorian).

 protected  void complete() 
{
        if (!isTimeSet) {
            computeTime();
            isTimeSet = true;
        }
        if (!areFieldsSet) {
            computeFields();
            areFieldsSet = true;
        }
}

Computes the time from the fields if the time has not already been set. Computes the fields from the time if the fields are not already set.

 abstract protected  void computeFields()
Computes the {@code Calendar} fields from {@code time}.

 abstract protected  void computeTime()
Computes {@code time} from the Calendar fields.

 public boolean equals(Object object) 
{
        if (this == object) {
            return true;
        }
        if (!(object instanceof Calendar)) {
            return false;
        }
        Calendar cal = (Calendar) object;
        return getTimeInMillis() == cal.getTimeInMillis()
                && isLenient() == cal.isLenient()
                && getFirstDayOfWeek() == cal.getFirstDayOfWeek()
                && getMinimalDaysInFirstWeek() == cal
                        .getMinimalDaysInFirstWeek()
                && getTimeZone().equals(cal.getTimeZone());
}

Compares the specified object to this {@code Calendar} and returns whether they are equal. The object must be an instance of {@code Calendar} and have the same properties.

 public int get(int field) 
{
        complete();
        return fields[field];
}

Gets the value of the specified field after computing the field values by calling {@code complete()} first.

 public int getActualMaximum(int field) 
{
        int value, next;
        if (getMaximum(field) == (next = getLeastMaximum(field))) {
            return next;
        }
        complete();
        long orgTime = time;
        set(field, next);
        do {
            value = next;
            roll(field, true);
            next = get(field);
        } while (next  > value);
        time = orgTime;
        areFieldsSet = false;
        return value;
}

Gets the maximum value of the specified field for the current date.

 public int getActualMinimum(int field) 
{
        int value, next;
        if (getMinimum(field) == (next = getGreatestMinimum(field))) {
            return next;
        }
        complete();
        long orgTime = time;
        set(field, next);
        do {
            value = next;
            roll(field, false);
            next = get(field);
        } while (next <  value);
        time = orgTime;
        areFieldsSet = false;
        return value;
}

Gets the minimum value of the specified field for the current date.

 public static synchronized Locale[] getAvailableLocales() 
{
        return Locale.getAvailableLocales();
}

Gets the list of installed {@code Locale}s which support {@code Calendar}.

 public String getDisplayName(int field,
    int style,
    Locale locale) 
{
		if (field <  0 || field  >= FIELD_COUNT) {
			throw new IllegalArgumentException();
		}
		if (ALL_STYLES == style) {
			if (!lenient) {
				throw new IllegalArgumentException();
			}
			style = SHORT;
		}
		if (SHORT != style && LONG != style) {
			throw new IllegalArgumentException();
		}
		DateFormatSymbols symbol = new DateFormatSymbols(locale);
		int fid = get(field);
		switch (field) {
		case MONTH:
			return (LONG == style ? symbol.getMonths()[fid] : symbol
					.getShortMonths()[fid]);
		case DAY_OF_WEEK:
			return (LONG == style ? symbol.getWeekdays()[fid] : symbol
					.getShortWeekdays()[fid]);
		case AM_PM:
			return symbol.getAmPmStrings()[fid];
		case ERA:
			return symbol.getEras()[fid];
		default:
			return null;
		}
}

answers the display name for given field, style and locale

 public Map<String, Integer> getDisplayNames(int field,
    int style,
    Locale locale) 
{
		if (field <  0 || field  >= FIELD_COUNT) {
			throw new IllegalArgumentException();
		}
		if (ALL_STYLES != style && SHORT != style && LONG != style) {
			throw new IllegalArgumentException();
		}
		complete();
		DateFormatSymbols symbol = new DateFormatSymbols(locale);
		Map< String, Integer > ret = new HashMap< String, Integer >();
		switch (field) {
		case MONTH:
			String[] months;
			switch (style) {
			case LONG:
				months = symbol.getMonths();
				break;
			case SHORT:
				months = symbol.getShortMonths();
				break;
			case ALL_STYLES:
				months = symbol.getMonths();
				for (int i = 0; i <  months.length; i++) {
					if (!months[i].equals("") && months[i] != null) {
						ret.put(months[i], i);
					}
				}
				months = symbol.getShortMonths();
				break;
			default:
				throw new IllegalArgumentException();
			}
			for (int i = 0; i <  months.length; i++) {
				if (!months[i].equals("") && months[i] != null) {
					ret.put(months[i], i);
				}
			}
			break;
		case DAY_OF_WEEK:
			String[] weekDays;
			switch (style) {
			case LONG:
				weekDays = symbol.getWeekdays();
				break;
			case SHORT:
				weekDays = symbol.getShortWeekdays();
				break;
			case ALL_STYLES:
				weekDays = symbol.getWeekdays();
				for (int i = 0; i <  weekDays.length; i++) {
					if (!weekDays[i].equals("") && weekDays[i] != null) {
						ret.put(weekDays[i], i);
					}
				}
				weekDays = symbol.getWeekdays();
				break;
			default:
				throw new IllegalArgumentException();
			}
			for (int i = 0; i <  weekDays.length; i++) {
				if (!weekDays[i].equals("") && weekDays[i] != null) {
					ret.put(weekDays[i], i);
				}
			}
			break;
		case AM_PM:
			String[] amPms = symbol.getAmPmStrings();
			for (int i = 0; i <  amPms.length; i++) {
				if (!amPms[i].equals("") && amPms[i] != null) {
					ret.put(amPms[i], i);
				}
			}
			break;
		case ERA:
			String[] eras = symbol.getEras();
			for (int i = 0; i <  eras.length; i++) {
				if (!eras[i].equals("") && eras[i] != null) {
					ret.put(eras[i], i);
				}
			}
			break;
		default:
			ret = null;
		}
		return ret;
}

answers a map of display names for given field, style and locale

 public int getFirstDayOfWeek() 
{
        return firstDayOfWeek;
}

Gets the first day of the week for this {@code Calendar}.

 abstract public int getGreatestMinimum(int field)
Gets the greatest minimum value of the specified field. This is the
biggest value that {@code getActualMinimum} can return for any possible
time.

 public static synchronized Calendar getInstance() 
{
        return new GregorianCalendar();
}

Constructs a new instance of the {@code Calendar} subclass appropriate for the default {@code Locale}.

 public static synchronized Calendar getInstance(Locale locale) 
{
        return new GregorianCalendar(locale);
}

Constructs a new instance of the {@code Calendar} subclass appropriate for the specified {@code Locale}.

 public static synchronized Calendar getInstance(TimeZone timezone) 
{
        return new GregorianCalendar(timezone);
}

Constructs a new instance of the {@code Calendar} subclass appropriate for the default {@code Locale}, using the specified {@code TimeZone}.

 public static synchronized Calendar getInstance(TimeZone timezone,
    Locale locale) 
{
        return new GregorianCalendar(timezone, locale);
}

Constructs a new instance of the {@code Calendar} subclass appropriate for the specified {@code Locale}.

 abstract public int getLeastMaximum(int field)
Gets the smallest maximum value of the specified field. This is the
smallest value that {@code getActualMaximum()} can return for any
possible time.

 abstract public int getMaximum(int field)
Gets the greatest maximum value of the specified field. This returns the
biggest value that {@code get} can return for the specified field.

 public int getMinimalDaysInFirstWeek() 
{
        return minimalDaysInFirstWeek;
}

Gets the minimal days in the first week of the year.

 abstract public int getMinimum(int field)
Gets the smallest minimum value of the specified field. this returns the
smallest value thet {@code get} can return for the specified field.

 public final Date getTime() 
{
        return new Date(getTimeInMillis());
}

Gets the time of this {@code Calendar} as a {@code Date} object.

 public long getTimeInMillis() 
{
        if (!isTimeSet) {
            computeTime();
            isTimeSet = true;
        }
        return time;
}

Computes the time from the fields if required and returns the time.

 public TimeZone getTimeZone() 
{
        return zone;
}

Gets the timezone of this {@code Calendar}.

 public int hashCode() 
{
        return (isLenient() ? 1237 : 1231) + getFirstDayOfWeek()
                + getMinimalDaysInFirstWeek() + getTimeZone().hashCode();
}

Returns an integer hash code for the receiver. Objects which are equal return the same value for this method.

 protected final int internalGet(int field) 
{
        return fields[field];
}

Gets the value of the specified field without recomputing.

 public boolean isLenient() 
{
        return lenient;
}

Returns if this {@code Calendar} accepts field values which are outside the valid range for the field.

 public final boolean isSet(int field) 
{
        return isSet[field];
}

Returns whether the specified field is set.

 public  void roll(int field,
    int value) 
{
        boolean increment = value  >= 0;
        int count = increment ? value : -value;
        for (int i = 0; i <  count; i++) {
            roll(field, increment);
        }
}

Adds the specified amount to the specified field and wraps the value of the field when it goes beyond the maximum or minimum value for the current date. Other fields will be adjusted as required to maintain a consistent date.

 abstract public  void roll(int field,
    boolean increment)
Increment or decrement the specified field and wrap the value of the
field when it goes beyond the maximum or minimum value for the current
date. Other fields will be adjusted as required to maintain a consistent
date.

 public  void set(int field,
    int value) 
{
        fields[field] = value;
        isSet[field] = true;
        areFieldsSet = isTimeSet = false;
        if (field  > MONTH && field <  AM_PM) {
            lastDateFieldSet = field;
        }
        if (field == HOUR || field == HOUR_OF_DAY) {
            lastTimeFieldSet = field;
        }
        if (field == AM_PM) {
            lastTimeFieldSet = HOUR;
        }
}

Sets a field to the specified value.

 public final  void set(int year,
    int month,
    int day) 
{
        set(YEAR, year);
        set(MONTH, month);
        set(DATE, day);
}

Sets the year, month and day of the month fields. Other fields are not changed.

 public final  void set(int year,
    int month,
    int day,
    int hourOfDay,
    int minute) 
{
        set(year, month, day);
        set(HOUR_OF_DAY, hourOfDay);
        set(MINUTE, minute);
}

Sets the year, month, day of the month, hour of day and minute fields. Other fields are not changed.

 public final  void set(int year,
    int month,
    int day,
    int hourOfDay,
    int minute,
    int second) 
{
        set(year, month, day, hourOfDay, minute);
        set(SECOND, second);
}

Sets the year, month, day of the month, hour of day, minute and second fields. Other fields are not changed.

 public  void setFirstDayOfWeek(int value) 
{
        firstDayOfWeek = value;
}

Sets the first day of the week for this {@code Calendar}.

 public  void setLenient(boolean value) 
{
        lenient = value;
}

Sets this {@code Calendar} to accept field values which are outside the valid range for the field.

 public  void setMinimalDaysInFirstWeek(int value) 
{
        minimalDaysInFirstWeek = value;
}

Sets the minimal days in the first week of the year.

 public final  void setTime(Date date) 
{
        setTimeInMillis(date.getTime());
}

Sets the time of this {@code Calendar}.

 public  void setTimeInMillis(long milliseconds) 
{
        if (!isTimeSet || !areFieldsSet || time != milliseconds) {
            time = milliseconds;
            isTimeSet = true;
            areFieldsSet = false;
            complete();
        }
}

Sets the time of this {@code Calendar}.

 public  void setTimeZone(TimeZone timezone) 
{
        zone = timezone;
        areFieldsSet = false;
}

Sets the {@code TimeZone} used by this Calendar.

 public String toString() 
{
        StringBuilder result = new StringBuilder(getClass().getName() + "[time="
                + (isTimeSet ? String.valueOf(time) : "?")
                + ",areFieldsSet="
                + areFieldsSet
                + // ",areAllFieldsSet=" + areAllFieldsSet +
                ",lenient=" + lenient + ",zone=" + zone + ",firstDayOfWeek="
                + firstDayOfWeek + ",minimalDaysInFirstWeek="
                + minimalDaysInFirstWeek);
        for (int i = 0; i <  FIELD_COUNT; i++) {
            result.append(',');
            result.append(fieldNames[i]);
            result.append('=');
            if (isSet[i]) {
                result.append(fields[i]);
            } else {
                result.append('?');
            }
        }
        result.append(']');
        return result.toString();
}

Returns the string representation of this {@code Calendar}.